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1 . INTRODUCTION 

The LEVEL 1 version of the 4010A01 PLOT 10 Terminal Control 
System is the equivalent of Release 3.3 of the previous 
PLOT 10 Software with minor updates. 

In order to allow the user to deal with many computer envi- 
ronments both for timesharing and minicomputers, TEKTRONIX 
has developed the Terminal Control System software package. 
The package is a comprehensive set of subroutines which 
allows terminal-independent graphic programming; the user 
needs only to select the proper subroutines at load time. 
The design is basically system and computer independent and 
enables the experienced programmer to work at the terminal 
level and also provides the facilities for the occasional 
user to operate easily at the conceptual level. The Ter- 
minal Control System consists of those subroutines which 
support the TEKTRONIX 4006-1, 4010, 4012/13* and 4014/15* 
Computer Display Terminals. 

Those who wish to enhance PLOT 10 Terminal Control System 
with 4662A01 PLOT 10 Utility Routine may then route output 
of TCS to the TEKTRONIX 4662 Inter-active Digital Plotter. 

RELEASE 3 AND EARLIER RELEASES 

1.1 THIS MANUAL IS DESIGNED FOR ALL USERS OF RELEASES 3.0 
THROUGH 3.3 AND LEVEL 1 OF THE TERMINAL CONTROL SYSTEM. 
ANY USER WHO OBTAINS THE PACKAGE AFTER THE DATE OF THIS 
MANUAL CAN PRESUME THAT HE HAS LEVEL 1. 



* The notation 4014/15 refers to either the 4014 or the 4015 terminals, the 
notation 4012/13 refers to either the 4012 or the 4013 terminal. The 4015 
and 4013 terminals are in all ways the same as their counterparts, but offer 
in addition an APL character set. 
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THE TEKTRONIX 
TERMINALS 



1.2 The 4006, 4010, 4012/13, and 4014/15 Computer 
Display Terminals are capable of displaying both alpha- 
numeric characters and graphic data. Once written, the 
display remains visisble until it is erased, and it is not 
necessary to continually refresh the information put up on 
the screen. The 4012 is an upper and lower case ASCII 
Terminal. The 4013 is an APL Terminal which also has the 
ASCII character set of the 4012. The 4014 and 4015 
Terminals offer upper and lower case ASCII, with the 4015 
also having APL capabilities. 

The 4014/15* Terminals offer in addition a write-through 
capability, in which both stored and refreshed information 
may be displayed. The 4014/15 Terminals have a display 
area of 14.5 inches by 10.9 inches, and the user has the 
option of four character sizes. The 4014/15 Terminals 
with Enhanced Graphics Module** offer hardware dashed 
lines and point plotting as well as incremental point 
plotting. The user may also address a grid of 1024 by 
1024 points or a grid of 4096 by 4096 points. 



A TERMINAL CONTROL 
SYSTEM OVERVIEW 



1.3 The ideal that the Terminal Control System strives 
for is to make the Terminal as easy to use as a pencil and 
a piece of paper. The detailed programming and general 
I/O handling are contained within the system; as a result 
the basic Terminal capabilities are made available to the 
user in a natural and practical manner. 



The Terminal Control System subroutines communicate with 
each other primarily through the Terminal Status Area, a 
set of common variables which continuously represent the 
current state of the Terminal and maintain the data and 
flags necessary to generate output according to the user's 
level of need. Terminal status cannot accurately be kept 
when output to the Terminal is generated by other means 
than through the appropriate Terminal Control System routine 
or whenever the user changes status locally (e.g., uses 
the PAGE or RESET key). 

The package gives many graphing conveniences to the user. 
Bright and dark vectors (line segments) as well as points 
may be displayed on the Terminal screen. A bright vector 
which can be seen on the screen, is caused by one of the 



The notation 4014/15 refers to the 4014 o£ the 4015 Terminal. 
4012/13 refers to either the 4012 or the 4013 Terminal. 



The notation 



** 



The Terminal Control System does not support special point plotting for the 
Enhanced Graphics Module. 
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"draw" routines. A "move" routine will cause a dark vector, 
the invisible equivalent of a bright vector; a "point" 
routine causes the display of a bright spot or point. Also 
included in the package are a choice of linear, logarithmic, 
or polar coordinate systems, automatic scaling of graphic 
data, and buffered input and output for faster, more 
efficient character handling. 

The following section deals with some of the subroutines 
which output bright and dark vectors (draws and moves, 
respectively) and points using Terminal screen coordinates. 
The values of these coordinates should be from to 1023 
unless a 4014/15 Terminal with the Enhanced Graphic Module 
is used (in which case addressing from through 4095 points 
is available) . The Y-axis coordinates should not exceed 
780 (or 3120 for the Enhanced Graphics Module) to remain 
visible on the screen. 



(0,780> 



Screen Margins- 



512 
< >-(512,390) 




.(1023,780) 



Screen 



1023,0) 



Screen Coordinates* 
Figure 1.3 



W 



The Screen Margins indicate the initial settings for alphanumeric line limits 
on the Terminal Screen. 
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2. INTRODUCTORY DRAWING 



INITIALIZATION: 2.1 Initialization of the Terminal and the Terminal 

q -Uy,^ +nY\P TNTTT Status Area must be accomplished as the first step in the 

use of Terminal Control System routines. This may be done 
by calling the initializing routine, INITT. When INITT is 
called the following events occur: 

(a) The screen is erased and the cursor (the small 
floating square which indicates the position 
where writing will occur) moves to the HOME 
position in the upper left hand corner of the 
screen. 

(b) The Terminal is set to alphanumeric mode. 

(c) The margin values are set to the left and 
right screen extremes. 

(d) The window is defined so that the portion of 
virtual space will be displayed which is 
equivalent in coordinates with the screen [i.e., 
(275, 763) in user coordinates is equivalent to 
(275, 763) in screen coordinates]. See sections 
3.0 through 3.2 for a description of virtual 
graphics. 

INITT requires the rate of character transmission from the 
computer to the Terminal as an input parameter in order that 
appropriate delays may be produced during screen erasure 
and hardcopy generation. This will prevent loss of data on 
remotely connected Terminals while they are not ready. 

CALLING SEQUENCE: 

CALL INITT (IBAUD) 

Parameter Entered: 

IBAUD - the transmission (baud) rate in 
characters per second. 
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TERMINATION: 
Subroutine FINITT 



2.2 When terminating a program which uses the Terminal 
Control System, it may be desirable to return the Terminal 
to alphanumeric mode and move the cursor to a point that 
will not interfere with any previous output. All output 
to the Terminal is buffered, or stored, until the user 
calls a routine that dumps the buffer, or until the buffer 
is full. 



FINITT automatically performs these functions. It 
terminates the program and outputs the contents of the 
buffer. Its arguments designate the position of the 
alphanumeric cursor upon program termination. FINITT 
should be used, depending on the computer system, either 
in conjunction with or in place of a FORTRAN STOP statement. 

CALLING SEQUENCE: 

CALL FINITT (IX, lY) 

Parameters Entered: 



ABSOLUTE LINE 

DRAWING IN 

SCREEN COORDINATES 



Subroutine MOVABS 



IX - the screen x-coordinate of the 

position to which the beam is moved 
before program termination. 

lY - the screen y-coordinate of the beam 
termination position. 

2.3 The three functions which do line drawing by 
referring to screen coordinate locations are MOVABS, DRWABS, 
and PNTABS. "ABS" stands for absolute; the drawing is 
called absolute because it is measured from a fixed point, 
the origin (0,0). The arguments of these routines are 
always in integer format. 

2.4 The argument of MOVABS is the pair of coordinates of 
the point to which a move is desired. Output starts at 
the stored current beam position. This position is updated 
after every line draw or other output command. In addition, 
all drawings are buffered. 

CALLING SEQUENCE: 

CALL MOVABS (IX, lY) 

Example : 

CALL MOVABS (100, 150) 
This call generates a move to (100, 150) so that 
that drawing can proceed from there . 



2-2 



4010A01 User 



Subvoutlne DRMBS 



2.5 DRWABS generates a bright vector from the current 
beam position to the coordinates given and updates the 
appropriate variables in the Terminal Status Area. 

CALLING SEQUENCE: 

CALL DRWABS (IX, lY) 

Example : 

CALL MOVABS (100, 50) 
CALL DRWABS (300, 50) 

These calls cause a move to (100, 50) and a 
subsequent line to be drawn from (100, 50) to 
(300, 50). 

Example : 

PROGRAM TO DRAW A TRIANGLE 



CALL INITT(3C) 

CALL nouABScioo.ieo) 

CALL DRUIAESOOe^lOO) 
CALL DRUABSC 300,187) 
CALL DRUABS < 100 , 100 ) 

CALL FINITT(0-767) 




Figure 2.5 
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Subroutine PNTABS 



2.6 PNTABS similarly moves to the coordinates given as 

arguments and displays a point there. 

CALLING SEQUENCE: 

CALL PNTABS (IX, lY) 



Example : 

CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 



INITTl3d) 
HOUABS C 300 aOO ) 
DRUABS(SOO.aOO) 
DRUAPS ( BOO . 4O0 ) 
DRIJABS ( 300 . 400 ) 
DRUIAES I 3O0 . 200 > 
PNTABS 1400. 3O0) 
FINITTC0,767) 




Figure 2.6 



RELATIVE LINE 
DRAWING IN SCREEN 
COORDINATES 



2.7 It is often easier to draw lines by indicating how 
many horizontal and vertical screen units to move relative 
to the last beam position. Negative relative movement is 
to the left or down. DRWREL, MOVREL, and PNTREL perform 
relative drawing in screen units. They have the same 
syntax as DRWABS , MOVABS , and PNTABS. 



Example: 



Draw the same box as in figure 2.6 with 
relative vectors. 

CALL INITTl30^ 
CALL NC'ABSi.SOO.aOO) 
CALL PRUREL ( £00. O) 
CALL PRUIPEL i O . 200 ) 
CALL PRIJREL f -200 . O ) 
CALL DRURELiO . -200 ) 
CALL PNTREL i 1 00 • 1 00 "« 
Cf^LL FINITT(C,767) 
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SCREEN GRAPHICS 
(Integer Argiments) 



ACTION 


ABSOLUTE 


RELATIVE 


MOVE 
DRAW 
POINT 


MOVABS 
DRWABS 
PNTABS 


MOVREL 
DRWREL 
PNTREL 



Figure 2.7 
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3. VIRTUAL AND SCREEN GRAPHICS 

This part deals with the most important relationships in 
the Terminal Control System, the translation of the User's 
data to a physical location on the screen. With an under- 
standing of this relationship between the data area and 
the Terminal screen the User can freely manipulate the 
display on the screen to reflect his need. For example, 
he can plot three different sets of data in the same screen 
display. 

The first group of sections in this part (1 through 6) 
discusses the display of the User's data area. This area 
may be conceived of as existing virtually within the 
computer, and is analogous to the sheet of paper on which 
graphic data is usually drawn. The data area is called 
virtual space . The unit of measurement in virtual space 
is arbitrary and representative of any unit the User wishes, 
from milligrams to light years. 

The second group of sections in this part (7 and 8) 
discusses how virtual data may be displayed by screen 
graphics in designated portions of the Terminal screen (the 
screen window) . Sections 9 and 10 deal specifically with 
the inter-dependence of virtual space graphics and screen 
graphics. Sections 11 and 12 discuss the drawing of dashed 
lines with both virtual space graphics and screen space 
graphics. 

TEE VIRTUAL WINDOW: 3.1 All or any portion of virtual space may be viewed 

at any time through the technique of windowing. The User 
defines in user units a rectangle, the virtual window , 
which utilizes that part of virtual space he wishes to 
view. Graphic lines (vectors) and portions of lines which 
lie outside the virtual window are a.utomatically eliminated 
or clipped by the graphic routines, while those which lie 
within or pass through the window are scaled and fitted 
into the appropriate portion of the screen. 
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A VIEWABLE AREA IN 

USER UNITS: 

(THE VIRTUAL WINDOW) 



3.2 Examine a graph as conceived in days and dollars 
and the method that will be used to display it on the 
screen. Suppose the following raw data is to be plotted 



DAY 


PROFIT 


1 


$ 30 


2 


26 


3 


42 


4 


38 


5 


40 


6 


50 


7 


54 


8 


48 


9 


40 


10 


52 



A virtual window is defined in virtual space with the lower 
lefthand corner at (0 days, 20 dollars). It is to extend 
horizontally on the x-axis for 10 days and vertically on 
the Y-axis for 40 dollars. One way of defining a 
rectangular window is to specify the lower lefthand corner 
and the horizontal and vertical dimensions. 

When the data is displayed on the screen, it is scaled in 
proportion to distances in the virtual window. Since the 
screen is 1024 units wide, it will be displayed (1/10) x 
1024=102 units from left to right on the screen. The 
point (1,30) is 1/4 of the distance, bottom to top, on the 
virtual window. The screen is 781 units high, so the point 
is displayed (1/4) x 781-195 units from the bottom of the 
screen (Figure 3.2). Every point on the virtual window is 
similarly translated to a point on the screen. 
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(0, 60) 



(10,60) 



1/4 of the vivtual 
window height 



(0, 20) 




(10,20) 
1/10 of the virtual window width 



THE VIRTUAL WINDOW 
Figure 3.2 



(0, 780) 



(1023,780) 



1/4 of the screen 
window height 









• 




- 




• 




« 


- 


• 

• 


• 




• 


- . (102, 


195) 


Sample 


Data 


Toint 


* 

— 1 — \— 


H — \ 


1 \ 


h 


-H \ 



The Screen 



1/10 of the screen width 



The Data of Figure 3.2 as Displayed on the Screen* 



*The code used to display Figure 3.2 may be seen on page 3-5. 
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DEFINING THE 
VIRTUAL WINDOW: 
Subroutine VWINDO 



Subroutine DWINDO 



3.3 The Terminal Control System uses one of two 
subroutines to define the virtual window. The first is 
VWINDO. 

CALLING SEQUENCE: 

CALL VWINDO (XMIN, XRANGE, YMIN, YRANGE) 

Parameters Entered: 

XMIN - the minimum horizontal user coordinate, 
XRANGE - the horizontal extent of the rectangle, 
YMIN - the minimum vertical user coordinate. 
YRANGE - the vertical extent of the rectangle. 
In the example of Figure 3.2, the calling sequence would be: 
CALL VWINDO (0. ,10. ,20. ,40. ) 

3.4 A second method of defining a virtual window may be 
employed by using the subroutine DWINDO. DWINDO uses a 
calling sequence similar to that of VWINDO. 

CALLING SEQUENCE: 

CALL DWINDO (XMIN, XMAX, YMIN, YMAX) 

Parameters Entered: 

XMIN - the minimum horizontal user coordinate, 

XMAX - the maximum horizontal user coordinate 

YMIN - the minimum vertical user coordinate. 

YMAX - the maximum vertical user coordinate. 

In the example of Figure 3.2, the calling sequence would be 

CALL DWINDO (0. ,10. ,20. ,60. ) 
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LIM DRAWING IN 
USER (VIRTUAL) 
UNITS: 

Absolute Line 
Drawing 



3.5 MOVEA, DRAWA, and POINTA are analogous to MOVABS, 
DRWABS, and PNTABS, but they allow points outside the 
virtual window to be referenced. Only those points or 
portions of bright vectors (line segments) which fall 
within the window boundaries, however, will be displayed; 
this is known as "clipping". 



CALLING SEQUENCE: 

CALL MOVEA (X, Y) 
CALL DRAWA (X, Y) 
CALL POINTA (X, Y) 

Parameters Entered: 

X - the horizontal virtual (real) coordinate to 
which a bright or dark vector is drawn or 
at which a point is displayed. 

Y - the vertical virtual (real) coordinate to 
which a bright or dark vector is drawn or 
at which a point is displayed. 

Using subroutine POINTA, we will display the data of 
Figure 3.2: 



lee 



DIMENSION X(10).Y(10) 
CALL INITTOO) 
CALL UUINDO(0 .10 
DATA X/'l . . 2 , 3 > 4 
DATA V '30 . ,aS A2 
DO 100 I-l, 10 
CALL POINTA<X(I ).Y(I )) 
CALL FINITT^ 0,767) 



SO , 40 ) 

5,6,7,8.9.10,^ 

38 , 40 . S0 . . 54 , 48 . , 40 , Sa / 



To work in user units on the screen, one could set up a 
virtual window that measures eight by six units. The 
following code will draw a three by three unit rectangle 
with the lefthand corner at (l.,l.) and a point in the 
middle. 
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CALL 


INITTOO^ 




CALL 


<.^UINDO(0 


• a 




CALL 


nOi.«EA(l , 


1 




CALL 


DRAUAC 1 , 


4 




CALL 


DRAUAC** 


A 




CALL 


DRAUAC4 


1 




CALL 


DRAUAd . 


1 . 




CALL 


POINTACa 


S, 


s 



... 6 . ) 



5) 



CALL FINlTT(e,767) 




Figure 3.5 



3-6 



4010A01 User 



RELATIVE VIRTVAL 

COORDINATE 

SUBROUTINES 



3.6 MOVER, DRA"WR, and POINTR draw straight lines, move, 
and display points respectively, relative to the current 
beam position. They are analogous to MOVREL, DRWREL, and 
PNTREL, (Section 2.7) except that they deal with user 
rather than screen units and clipping, as described above, 
may occur. 

The following code will produce the same rectangle as that 
of Figure 3.5. 



CALL INITTOO) 

CALL UUINDOCO ,8 0.6 ) 

CALL MOUEAd , 1 ) 

CALL DRAUR (0 3 ) 

CALL DRAURO .0 ) 

CALL DRAUIRCO. ,-3 ) 

CALL DRAUR (-3 .0 > 

CALL POINTRd 5.1 5) 

CALL FINITTCC,767) 



SCREEN GRAPHICS 


VIRTUAL GRAPHICS 


(Integer Arguments) 


(Real Arguments) 


ACTION 


ABSOLUTE 


RELATIVE 


ABSOLUTE 


RELATIVE 


MOVE 


MOVABS 


MOVREL 


MOVEA 


MOVER 


DRAW 


DRWABS 


DRWREL 


DRAW A 


DRAWR 


POINT 


PNTABS 


PNTREL 




POINTA 


POINTR 



Figure 3.6 
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THE SCREEN WINDOW 



Subroutine SWINDO 



Subroutine TWINDO 



SCALING AND 
STRETCHING THE 
SCREEN WINDOW 



3.7 So far, to display a drawing in virtual space the 
entire screen has been used. But any rectangular portion 
of the screen can be used as a display area. This display 
area is called the screen window, and it is defined by the 
subroutines SWINDO and TWINDO. The two subroutines stand 
in the same relation to each other as do VWINDO and DWINDO 
(see Sections 3.3 and 3.4); like all arguments in screen 
terms, the arguments of SWINDO and TWINDO are in integer 
format . 

3.7.1 CALLING SEQUENCE: 

CALL SWINDO (MINX, LENX, MINY, LENY) 
Parameters Entered: 

MINX - the minimum horizontal screen coordinate, 
LENX - the horizontal extent of the rectangle. 
MINY - the minimum vertical screen coordinate. 
LENY - the vertical extent of the rectangle. 

3.7.2 CALLING SEQUENCE: 

CALL TWINDO (MINX, MAXX, MINY, MAXY) 
Parameters Entered: 

MINX - the minimum horizontal screen coordinate. 
MAXX - the maximum horizontal screen coordinate, 
MINY - the minimum vertical screen coordinate. 
MAXY - the maximum vertical screen coordinate. 

3.8 The points of the virtual window are scaled to fit 
into the screen window in the same manner as they previously 
fitted into the entire screen. Consider again the data of 
Figure 3.2. 

The following program illustrates how the size and shape of 
the screen window can be manipulated by changing the 
dimensions of TWINDO. Note that all of the virtual data 
is displayed in each case. 
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C * DeriONSTRATION OF SCALING AND STRETCHING 

CALL INITT (30) 

CALL DUINDO (0 .ie.>20 ,60.) 
C « DRAU THE SAME GRAPH IN FOUR TERMINAL UINDOUS 

CALL TUINDO (0.200,550,700) 

CALL GRAF IT 

CALL TUINDO < 300 .. 900 , 550 , 700 ) 

CALL GRAF IT 

CALL TUIINDO (O . 300 . 0> 450 ) 

CALL GRAF IT 

CALL TU I NDO ( 300 , 900 . . 450 ) 

CALL GRAF IT 
C * nAK:E HARDCOPY 

CALL HDCOPV 

CALL FINITT(O,760) 

END 



C % SUBROUTINE TO DRAU GRAPH UIHICH FILLS TERMINAL UINDOU 

SUBROUTINE GRAF IT 

DIMENSION X(10),V(10) 

DATA X/1 .2,3>4.,5,6.,7.,8.,g.,10/ 

DATA V.'30 . 26 . 42 , 38 . 40 . 50 . , 54 , 48 , 40 , 52 / 

CALL M0UEA(X(1 ),V(1) ) 

DO 100 1-1,10 
100 CALL DRAUACXd ),V(I)) 
MOUEA ( , 20 ) 



CALL 

CALL 

CALL 

CALL 

CALL 

RETURN 

END 



DRAUA(10 ,20. ) 
DRAUACIO ,60. ) 
DRAUA(0. ,60 ) 
DRAUA (0 ,20 ) 







Figure 3.8 
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CLIPPING IN 
VIRTUAL SPACE: 



3.9 To see only a portion of the data, the user can 
change VWINDO/DWINDO to include only the desired section. 
When drawing is done in user (virtual) units, that portion 
of the drawing is clipped which occurs outside the present 
virtual window. Clipping occurs in all virtual graphics : 



DinetisiON x(i0),v<ie) 

DATA X^l .,2..3.,4>5,6.,7.8 
DATA V/3e . 26 , 48 , 38 , 40 . , 50 
CALL INITT<30) 
CALL SyiNDO(4OO,3O0,200,4O0) 
CALL UUINDOO ,5 .40 . 15 ) 
CALL nOUEACXCD.Vd)) 
DO 100 1-1, 10 
IOC CALL DRAUACXd ),V(I )) 
n0UABSC400.S00) 
DRUABS(700.200) 
DRUIABS(700.600) 
DRUABS ( 400 . 600 ) 
DRUABS ( 400 . 200 ) 
FINITT<0,767) 



>9. 
,54 



10 /^ 

.48. 



40 . 52 / 



CALL 
CALL 
CALL 
CALL 
CALL 

CALL 
STOP 
END 




Figure 3.9 
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INTERCHANGEABILITY 3.10 The user may locate a point in virtual space which 

OF VIRTUAL AND SCREEN is not within the limits of the virtual window. He may 
GRAPHICS: draw to and from this point with no difficulty since the 

drawing will automatically be scaled and clipped by the 
window definition. The same is not true of screen space, 
which is defined entirely by the limits of the screen. 

Therefore, a transition from screen to virtual space can 
always be accomplished, but the reverse is not true. If a 
point in virtual space is designated which does not appear 
on the screen window, a draw using screen coordinates will 
originate at the beam's last visible position within the 
screen window and not at the expected virtual point. In 
addition the user must be aware of wrap-around if he 
addresses a point which is off the screen. 

Example : 

The screen coordinates (1500,0) will cause 
wrap-around (e.g., A relative draw to the 
above coordinates will result in a vector 
on the X-axis drawn (1500-1024) raster 
units from the current beam position.) 



See Figure 3.10 
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Screen Window 



A line drawn in user (virtual) 
coordinates from point A to 
•point B and hack to point C 



A line dra:um in virtual 
coordinates from A to B and 
in screen coordinates hack to 
C. B is a point outside the 
screen window, hut within the 
screen limits. 

This draw reflects a user 
error 



Figure 3.10 
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DASHED LINE 
DRAWING 



3.11 Dashed lines of nearly infinite variety may be 
drawn through the use of the Terminal Control System in 
both virtual and screen space. The four basic dashed 
line subroutines are DSHABS, DSHREL, DASHA, and DASHR. 
These routines are analogous to DRWABS, DRWREL (Sections 
2.5 and 2.7), DRAWA, and DRAWR (Sections 3.5 and 3.6); 
each dashed line subroutine, however, has a third, integer- 
format argument. This third argument controls the type of 
dashed line displayed, and it can take any integer value 
from -1 to the largest integer, less than or equal to 
9999999999, which your computer can accept. 



DASHED LINE 
SPECIFICATIONS: 
larameter L 



CALLING SEQUENCES: 

CALL DSHABS (IX, lY, 
CALL DSHREL (IX, lY, 
CALL DASHA (X, Y, L) 
CALL DASHR (X, Y, L) 



L) 
L) 



IX, lY (integer) and X, Y (real) are the coordinates the 
dashed line is drawn to and L is the dash type specification. 

3.12 Software dashed lines may be specified on any 
TEKTRONIX graphics display terminal with a concatenation 
of the following code numbers: 



1-5 raster units , 
2-5 raster units, 
3-10 raster units 
4-10 raster units 
5-25 raster units 
6-25 raster units 
7-50 raster units 
8-50 raster units 



visible 
invisible 
, visible 
, invisible 
, visible 
, invisible 
, visible 
, invisible 



Example : 

CALL DSHABS (200, 700, 3454) 

The software also uses single digits to specify (L) : 

-1 causes a move 

causes a draw 

9 alternate visible and invisible segments 
between data points. 

Example : 

CALL DSHABS (200, 700, -1) 
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Four types of hardware dashed lines are available on the 
4014/15 Terminal with Enhanced Graphic Module (see TERM, 
Section 5.1). The hardware dashed line specifications are 
fast and efficient and may be used by any TEKTRONIX Graphic 
Display Terminal. If the terminal hardware is not capable 
of generating the hardware dash, then the software will 
approximate the type according to the following key: 

1 - a dotted line 

2 - a dash-dot line 

3 - a short-dashed line 

4 - a long-dashed line 

Example : 

CALL DSHABS (200, 700, 2) 

The following example illustrates two software-simulated, 
hardware dash types (2 and 3). Function KIN (Section 4.13), 
here to make relative draws: 
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C « SAMPLE DRAUINQ OF A FLANGE 
CALL INITTOO) 
CALL nOUABSddO.Se) 
CALL DRUIREL<0>KIN(5 )) 
CALL DRUREL(KIN(0.5>>e) 
CALL DRUREL(0.-KIN<5 )) 
CALL DRURELC-KINCe 5),0) 
CALL nOUREL(KlN(C.5),KIN(1.5)) 
CALL DRUiPEL(KIN(a.e)«0) 
CALL DRUREL(0.KIN<a.0)) 
CALL DRUREL(-KIN(2.0)/C) 
CALL nOUREL<KIN<a 0),-KIN(0.a5)) 

C * DRAU DASHED 'HIDDEN' LINES 

CALL DSHREL(-KIN(a.5),0,3) 
CALL M0UREL(KIN(a.5).-KIN(l .5)) 
CALL DSHRELC-KINCa 5),0,3) 
CALL nOURELCKIN(3,e),KIN(0.75)) 

C * DRAU DASHED 'CENTER LINE' 

CALL DSHREL(-KIN(3 5)>0,2) 

CALL FINITTCe.e) 

END 
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SCREET^ GRAPHICS 
(Integer Avgyments) 



VIRTUAL GRAPHICS 
(Real Avgyments) 



ACTION 


ABSOLUTE 


RELATIVE 


ABSOLUTE 


RELATIVE 


MOVE 


MOVABS 


MOVREL 


MOVEA 


MOVER 


DRAW 


DRWABS 


DRWREL 


DRAWA 


DRAW 


POINT 


PNTABS 


PNTREL 


POINTA 


POINTR 


DASH 


DSHABS 


DSHREL 


DASHA 


DASHR 



Figure 3.12 
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4. UTILITY ROUTINES 



ALPHANUMERIC 
OUTPUT 



4.1 By allowing the Terminal Control System to monitor 
alphanumeric (A/N) output rather than using FORTRAN READ 
and WRITE statements, it is possible to maintain Terminal 
status, especially the tracking of the beam position. This 
tracking is required for tab and margin control as well as 
for facilitating the mixture of A/N and graphic output. As 
with graphic output, alphanumeric output is buffered, or 
stored, until a routine is called to dump the buffer, or 
until the buffer is full. 



ENTEEING A/N 

MODE: 

Subroutine ANMODE 



4.2 At times the user may wish to output A/N data other 
than through the Terminal Control System. In such cases it 
is the user*s responsibility to insure that the Terminal is 
in A/N mode. This can be done by using ANMODE. It is not 
necessary to call ANMODE when using the Terminal Control 
System routines as they will automatically call it whenever 
necessary. ANMODE can be used to dump the output buffer.* 



CALLING SEQUENCE: 
CALL ANMODE 



A/N CHARACTER 
OUTPUT: 
Subroutine ANCHO*'' 



4.3 Non-control alphanumeric characters are monitored 
when output through ANCHO. A/N mode will be entered if 
necessary and the Terminal Status Area representation of 
the screen beam position is updated as characters are 
output. If the outputting of the character advances the 
beam beyond the right margin setting, a new line is 
automatically generated. 



The input argument is assumed to be a 7-bit ASCII, non- 
control character which is right-adjusted within an integer 
word. ANCHO does not check this input variable. Any but 
the expected input will result in erroneous beam status 
information. 



* The positioning on the Terminal screen of non-Terminal Control System output 

(such as a FORTRAN WRITE) is dependent upon the way in which the software package 
is implemented on your computer. See Section 7.11.1 for details. If all output 
is through the Terminal Control System, no such implementation dependencies exist, 

** This routine is also discussed in Section 7.3. 
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ANCHO updates the beam according to the character size set. 
All character sizes are correctly updated in 4096 grid 
space. In 1024 space, however, only the large size 
characters are correctly updated; the other sizes are 
fractional screen units in width, forcing the beam update 
to be an approximation to within 1/2 a screen unit of the 
true beam position. 

CALLING SEQUENCE: 

CALL ANCHO (ICHAR) 

Parameter Entered: 

ICHAR - An integer which represents a 
7-bit ASCII character, right- 
adjusted. NOT a control character. 

For an example of ANCHO, see Section 5.4. 

A/B STRim OUTPUT 4.3.1 ANSTR functions in all respects like ANCHO above. 

Subroutine ANSTR'^ except that it allows the user to output an alphanumeric 

string instead of a single character. The arguments of 
ANSTR are NCHAR, the number of characters to be output, and 
NADE, the arrary of ASCII decimal equivalent integers which 
represents the string to be output. 

CALLING SEQUENCE: 

CALL ANSTR (NCHAR, NADE) 

Parameters Entered: 

NCHAR the number of characters to be 
output . 

NADE An array containing the ASCII 

decimal integer equivalents for 
the characters to be output. 

4.4 A/N CHARACTER HANDLING 

Subroutine NEWLIN Generates a line feed and carriage return. 

CALL NEWLIN 
Subroutine LINEF : Generates a line feed. 

CALL LINEF 



*This routine is also discussed in Section 7.4. 
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Subvoutine CARTN 
Subroutine HOME 

Subroutine BAKSP'^ 
Subroutine NEWPAG 



USING THE SCREEN 
CURSOR: 

Subroutine SCURSR'^'' 



Subroutine DCURSR'^'^ 



Generates a carriage return 

CALL CARTN 

Moves the alphanumeric cursor to the upper left corner of 
the screen. 

CALL HOME 

Generates a backspace. 

CALL BAKSP 

Erases the Terminal screen and returns the alphanumeric 
cursor to the HOME position. 

CALL NEWPAG 

4.5 The graphic cursor may be used to specify screen 
coordinates directly. Calling SCURSR will activate the 
graphic cursor, allowing the user to position it. The 
cursor position is transmitted to the computer when a 
keyboard character is struck. This character along with 
the input position is returned as arguments by SCURSR. 
The Terminal Control System compensates for effects on 
the beam position caused by the graphic cursor. 

CALLING SEQUENCE: 

CALL SCURSR (ICHAR, IX, lY) 

Parameters Returned: 

ICHAR - a keyboard character, 7-bit ASCII 
right-adjusted . 

IX - the screen x-coordinate of the 
graphic cursor. 

lY - the screen y-coordinate of the 
graphic cursor. 

The following example (Figure 4.5) demonstrates a use of 
the screen cursor. ANMODE (Section 4.2) is called to print 
out the coordinates of the screen cursor. 

4.5.1 DCURSR accomplishes the same function as SCURSR 
above. It's calling sequence and arguments are also the 
same. 



* Not supported on the 4006-1 Terminal. To achieve a backspace, substitute the 
following: CALL MOVREL (-LINWDT(l) ,0) This is done automatically 

for Terminal type (See subroutine TERM) 

** Not supported on the 4006-1 Terminal. 
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10 



se 



CALL INITT (30) 

CALL SCURSR ( ICHAR, IX, IV) 

CALL PNTABS (IX, IV) 

CALL ANflODE 

URITE (5,a0) IX, IV 

FORflAT (1H+,»,I5.I4)* 

IF CICHAR NE 83) QO TO 10 

CALL FINITT (0,0) 

END 



SAMPLE CURSOR SELECTION; 



m 247 510 



' 70g gig> 



A Representation of the 
Graphic Cursor. 



247 229 



, 709 829 



Figure 4.5 



* 1H+, $ is the PDP-10 processor's carriage-return suppression format 
(See Implementation Notes) 
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USING TEE VIRTUAL 
CURSOR: 
Suhvoutine YCURSR'^ 



4.6 It is often useful to be able to retrieve virtual 
rather than screen coo-dinates with the graphic cursor. 
The routine VCURSR allows the user to enable the graphic 
cursor. After the cursor has been positioned, its screen 
coordinates may be transmitted to the computer by striking 
a keyboard character. VCURSR transforms the input data 
into virtual coordinates according to the current window 
definition. The virtual cursor does not affect the beam 
position. 

The transformation which VCURSR effects assumes that all 
of the screen is a continuation of virtual space with the 
scale implied by the current window. 

CALLING SEQUENCE: 

CALL VCURSR (ICHAR, X, Y) 

Parameters Returned : 

ICHAR - a keyboard character, 7-bit ASCII, 
right-adjusted. 

X - the virtual x-coordinate of the 
graphic cursor. 

Y - the virtual y-coordinate of the 
graphic cursor. 

The following example of VCURSR allows the user the 
capability of interactive line drawing. When a character 
is struck, a line segment is drawn or a move is made from 
the current beam position to the coordinates specified by 
the graphic cursor. 



* Not supported on the 4006-1 Terminal. 
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DinENSIOH FR<V1E(8) 

DATA FRAne^l. ,0. ,1 

CALL 1N1TTC120) 
C « SPECIFY MINinunS AND EXTENTS OF UlNDOWS 

CALL SyiNDO(250.50O.150.5Oe) 

CALL UUINDO<e .1. .0 ,1. ) 
C » FRAME THE SCREEN UINDOU 

CALL nOUEA(0 ,0. ) 

DO 100 I-1.8«a 
100 CALL DRAWACFRACIECD^FRAnECI-H)) 
C « SAMPLE THE CURSOR REPEATEDLV 
150 CALL ANMODE 

CALL ^X)URSRCIBR.X,V) 
C * A "P- IS STRUCK 

IF<IBR.EQ 80)GO TO 200 
C « A -D* IS STRUCK 

IFCIBR EQ.68)G0 TO 300 
C * AN -n- IS STRUCK 

IFfIBR.EQ.77)G0 TO 400 
C * AN -S" IS STRUCK 

IFCIBR EO 83)G0 TO 500 

GO TO 150 
20O CALL POINTA(X,V) 

GO TO 150 
300 CALL DRAUA(X.Y) 

GO TO 150 
400 CALL nOUEACX,V) 

GO TO 150 
500 CALL ANMODE 

CALL FINITT<0.767) 

END 




Figure 4.6 
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TERMINAL STATUS 
AREA : 



4.7 The Terminal Status Area is a set of variables which 
are kept in a common block and represent the current state 
of the Terminal, The Terminal Control System allows the 
user to save the current Terminal status and return to it 
at a later time. 



Subroutine SVSTAT 



Subroutine RESTAT 



Although it does not save the displayed data, this facility 
does allow the user to interrupt his processing, move to 
another location, do other processing there or interact 
with the user, and then return to his original processing. 

Since the user allocates the save areas, he may easily save 
more than one level of status and may restore any of his 
saved states at any time. 

4.7.1 The current status of the Terminal may be saved by 
providing the status saving routine with a 60-word real 
array in which the Terminal Status Area may be stored. 

WARNING: The status of dashed lines cannot be saved and 
used again reliably. 

CALLING SEQUENCE: 

CALL SVSTAT (RARRAY) 
Parameter Entered: 

RARRAY - a 60-word real array. 

4.7.2 The Terminal may be restored to any previously 
saved state at any time by providing the status restoring 
routine with the 60-word real array in which the previous 
Terminal Status Area was stored. 

CALLING SEQUENCE: 

CALL RESTAT (RARRAY) 

Parameter Entered: 

RARRAY - the 60-word array containing 

previously stored terminal state. 
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100 

c 



CALL INITTOC) 

DIMENSION IB0X(8).. ITinE<8 ) . BC60) - T«:60 ) 
DrtTfif I BOX 200 ,0,0. 300 , -200 ,0.0. -200/ 
DATA ITinE/S0 , , -80 , 120 , 80 • . -80 , -120/ 
CALL nOUABS C 400 . 300 ) 
SAUE CURRENT TERMINAL STATUS 
CALL SUSTATCB) 
CALL MOUAB5 C 460 , 340 ) 
CALL SUSTAT(T) 
DO 100 N-1,7.2 

CALL PRURELiITIHECN), ITIME<N+1 )) 
CALL S«.»STAT(T) 
RESTORE STATUS 

CALL RESTATE B) 

DRUREL(.IBOXCN),IBO><iN+l )) 

SUSTAT t. B ) 

RESTAT(T ) 

HARDCOPV 

HDCOPV 

FINITT(0,767) 



CALL 
CALL 
CALL 
OPTIOriAL 
CALL 
CALL 
STOP 
END 




Figure 4.7 



4-8 



4010A01 User 



RESCALING A 
GRAPHIC OUTPUT: 

Subroutine RSCALE^ 



ROTATING GRAPHIC 
OUTPUT: 

Subroutine RROTAT* 



4.8 A graphic figure drawn with relative coordinates may 
be rescaled by any virtual, relative factor which is com- 
patible with the virtual window definition; that is, a 
figure will be clipped if its dimensions exceed the limits 
of the virtual window. 

CALLING SEQUENCE: 

CALL RSCALE (FACTOR) 

Parameter Entered : 

FACTOR - the rescaling factor relative to the 
original size of the display. 

4.9 A graphic figure drawn with relative coordinates may 
be rotated at any angle relative to its original display 
position. 

CALLING SEQUENCE: 

CALL RROTAT (DEC) 

Parameter Entered: 

DEC - the angle of rotation relative to the 
position of the original display. 

The following example draws a triangle, then rescales it by 
a factor of 2 and rotates it by 90° to obtain the second 
triangle. 



* Those user's who have an old version of the TEKTRONIX Character Generation system 
(Part No. 062-1494-00) should delete the above routines from their Character 
Generation System software and use these subroutines in their place. The current 
version of the 4010A05 Plot 10 Character Generation System does not contain RSCALE 
or RROTAT. 
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CALL INITTO0) 
CALL TPIANCC200 ,200 ) 
C DOUBLE SCALE SIZE 

CALL RSCALEia ) 
CALL RR0TATC90 ) 
C ROTATED 90 DEGREES AND REDRAU 
CALL TRIANG(700 ,400 ) 
TINPUT(K) 
FINITTCICIO) 



CALL 
CALL 
STOP 
END 



SUBROUTINE TRIANGCX^V) 

CALL nOUEAtX.Y) 

CALL M01€:R<-100 ,-100 

CALL DRAUR(200 ,0 ) 

CALL DRAyR( -100 , 200 > 

CALL DRAUR< -100 , -200 

CALL POINTRCIOO ,100 ") 

RETURN 

END 




Figure 4.9 
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Subroutine RESET 



Subroutine RECOVR 



MISCELLANEOUS 
UTILITY ROUTINES: 

Subroutine HDCOPI 



Subroutine ERASE 



Subroutine BELL 



4.10 This routine accomplishes the same function as 
INITT (see Section 2.1), but it does not call for a new 
page. 

CALLING SEQUENCE: 

CALL RESET 

4.11 RECOVR updates the Terminal hardware to match the 
Terminal Status Area variables. It is useful following 
output to the Terminal which is outside the realm of the 
Terminal Control System (e.g., a FORTRAN WRITE). 

CALLING SEQUENCE: 

CALL RECOVR 

4.12 The user who is equipped with the TEKTRONIX 
hardcopy unit appropriate to his terminal may have the 
computer generate a hardcopy of the screen contents at 
any time. This may be accomplished while in any mode and 
does not affect the Terminal Control System status. The 
system will prevent generation of additional output until 
the hardcopy is completed. 

CALLING SEQUENCE: 

CALL HDCOPY 

The Terminal screen may be erased without changing the 
mode or beam position. The Terminal Control System will 
prevent generation of additional output until the erase 
is completed. 

CALLING SEQUENCE: 

CALL ERASE 

An audible tone may be output at any time to call the 
user's attention to a particular event. Often a sustained 
audible output, which may be generated by a series of calls 
to the bell routine is used for an alarm. The "bell" may 
be sounded while in any mode except GIN (Graphic Input) 
mode and has no affect on Terminal Status. 



CALLING SEQUENCE: 
CALL BELL 



4010A01 User 



4-11 



Subroutine SEETW Returns the current values of the screen window. 

CALLING SEQUENCE: 

CALL SEETW (MINX, MAXX, MINY, MAKY) 

Parameters Returned: 

MINX - the minimum horizontal screen coordinate, 

MAXX - the maximum horizontal screen coordinate, 

MINY - the minimum vertical screen coordinate. 

MAXY - the maximum vertical screen coordinate. 

Subvoutine SEEDW Returns the current values of the virtual window limits. 

CALLING SEQUENCE: 

CALL SEEDW (XMIN, XMAX, YMIN, YMAX) 

Parameters Returned : 

XMIN - the minimum horizontal user coordinate. 
XMAX - the maximum horizontal user coordinate. 
YMIN - the minimum vertical user coordinate. 
YMAX - the maximum vertical user coordinate. 

Subroutine SEEREL Returns the values of the common variables used by the 

relative virtual routines to scale and rotate vectors. 

CALLING SEQUENCE: 

CALL SEEREL (RSCOS, RSIN, SCALE) 

Parameters Returned: 

RCOS - the cosine of the rotation angle. 
RSIN - the sine of the rotation angle. 
SCALE- the multiplier used for scaling. 

Subroutine SEETRN Returns the value of the common variables set by the window 

and transformation routines. 

CALLING SEQUENCE: 

CALL SEETRN (XFAC, YFAC, KEY) 

Parameters Returned: 

XFAC - the X scale factor 
YFAC - the y scale factor 
KEY - the transformation key 

1 = linear 

2 - log 

3 = polar 
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CONVERSION OF 4.13 The function routine KIN transforms inches to 

INCHES TO SCREEN screen units. It provides the number of raster units in 

UNITS: (RI) inches. 

Function KIN CALLING SEQUENCE: 

Variable = KIN (RI) 
Parameter Entered: 

RI - the number of inches. 

Parameter Returned: 

KIN - the number of raster units in 
(RI) inches . 

Example : 

KIN is a means of determining a screen 
position when the user wishes to work with 
virtual units. 

IX = KIN (1.4) 

CALL DRWREL (IX, 0) 

CONVERSION OF 4.14 The function routine KCM transforms centimeters to 

CENTIMETERS TO screen units. It provides the number of raster units in 

SCREEN UNITS: (RC) centimeters. 

Function KCM CALLING SEQUENCE: 

Variable = KCM (RC) 
Parameter Entered: 

RC - the number of centimeters. 

Parameter Returned: 

KCM - the number of raster units in 
(RC) centimeters. 

Example : 

KCM is a means of determining a screen 
position when the user wishes to work 
with virtual units. 



IX = KCM (3.5) 
CALL DRWREL (IX, 0) 
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MEASURING THE 
WIDTH OF 
CHARACTERS: 

Function LINWT 



4.15 LINWDT provides the width in raster units as an 
accurate measure of the horizontal size of a given number 
of adjacent characters. The context is the current screen 
coordinate system (1024 addressable points vs. 4096 
addressable points) . 

CALLING SEQUENCE: 

Variable = LINWDT (NUMCHR) 

Parameter Entered: 

NUMCHR - the number of adjacent characters 
for which the width in raster 
units is desired. 

Parameter Returned: 

LINWDT 



- the width in raster units of 
NUMCHR characters in the current 
character size. 



MEASURING THE 
HEIGHT OF LINES: 

Function LINHGT 



4.16 LINHGT provides in raster units the accurate 
measure of the height of a given number of lines. 

CALLING SEQUENCE: 

Variable = LINHGT (NUMLIN) 

Parameter Entered: 

NUMLIN - the integer number of lines for 
which the height in raster units 
is desired. 

Parameter Returned: 

LINHGT - the height in raster units of 
NUMLIN lines in the current 
character size (see CHRSIZ, 
Figure 5.3). 
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TABS Am MARGINS 



SETTING THE TAB 
TABLE: 

Subroutine TTBLSZ 



4.17 The Terminal Control System allows the user to 
set and reset tabs and margins to facilitate format layout. 
The tab and margin settings are software generated and as 
such are useful only for A/N output through Terminal Control 
System routines. All tab and margin values are in screen 
coordinates. Both horizontal and vertical tabs and left and 
right margins are available; both horizontal and vertical 
tabs are limited to ten positions each. 

4.17.1 Tab settings for both horizontal and vertical 
tabs are kept in two ten-word integer arrays. The settings 
are ordered with ascending screen coordinates, the first 
zero value indicating the end of the settings. TTBLSZ 
sets up the size of the integer array. The horizontal and 
vertical arrays must be equal in size. 



CALLING SEQUENCE: 

CALL TTBLSZ (ITBLSZ) 

Parameter Entered : 

ITBLSZ - the size of the tab table 
(horizontal and vertical) 
expressed as an integer 
from 1 to 10. 



TAB SETTING: 
Subroutine SETTAB 



4.17.2 The routine SETTAB takes a given tab setting in 
screen coordinates and inserts it into the given tab table. 
If the tab is full, the maximum setting will be lost in 
order that a lessor tab setting may be inserted. Although 
duplicate tab settings are not inserted, SETTAB does not 
generally check the tab setting for validity nor does it 
know whether the given tab table is horizontal or vertical.* 



CALLING SEQUENCE: 

CALL SETTAB (ITAB, ITBTBL) 

Parameters Entered: 

ITAB - tab setting in either X or Y 
coordinates. 

ITBTBL - the horizontal or vertical tab 
table (Array Name) . 



* SETTAB expects ITBTBL to be initialized to zero. If the system does not do this 
automatically, the user should do it with a DATA statement. 
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REMOVING A TAB: 
Subroutine RSTTAB 



4.17.3 To remove a tab selectively, its position in 
screen coordinates (ITAB) must be entered along with the 
proper tab table. Non-zero values which do not coorespond 
to a current tab setting are ignored. If the value of the 
tab position is 0, the entire tab table will be removed. 

CALLING SEQUENCE: 

CALL RSTTAB (ITAB, ITBTBL) 

Parameters Entered: 



TEE HORIZONTAL TAB. 
Subroutine TABHOR 



ITAB - the X or Y screen coordinate of 
the tab to be removed. If the 
number is 0, all tabs in the tab 
table designated will be removed. 

ITBTBL - the horizontal or vertical tab 
table (Array Name) . 

4.17.4 Calling the horizontal tab routine will cause the 
alphanumeric cursor to be moved with a constant Y-value to 
the position specified by the first non-zero entry in the 
horizontal tab table, IHORZ, which is greater than the 
current screen X-coordinate of the cursor or beam position. 
If the horizontal tab table is empty, no action will occur. 
If the tab table is not empty and no entry exists which is 
greater than the current screen X-coordinate of the cursor 
or beam position, or if the first non-zero entry greater 
than the screen X-coordinate is also greater than the right 
margin setting, a new line will be generated. 

CALLING SEQUENCE: 

CALL TABHOR (ITBTBL) 
Parameter Entered: 

ITBTBL - the name of the horizontal table. 
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TEE VERTICAL TAB: 4.17.5 Vertical tabbing will cause the alphanumeric 

cursor to be moved with a constant X-value to the position 

Suhvoutvne TABVER specified by the last non-zero entry in the vertical tab 

table which is less than the current Y-coordinate of the 
cursor on beam position. If no such entry exists, then no 
action is taken. 

CALLING SEQUENCE: 

CALL TABVER (ITBTBL) 

Parameter Entered: 

ITBTBL - the name of the vertical tab table 
(see SETTAB, Section 4.17.2). 

The following example sets the tabs and resets them, 
putting our characters with the help of subroutine ANCHO 
(Section 4.3). 
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so 

lOO 



CALL INITT (30) ^'^»^'»^ 

CALL TTBLS2 (4) 

CALL SETTAB <20,IHOR2) 

CALL SETTAB (50,IH0R2> 

CALL SETTAB (a50,IH0R2) 

CALL SETTAB (400.1HOR2) 

CALL SETTAB ( 750 . lUERT ) 

CALL SETTAB (600,1UERT) 

CALL SETTAB (500,IUERT) 

CALL SETTAB (a33,igERT) 

DO 100 IUTAB-1.4 

IF (lUTAB EQ 3) CALL 

IF" clUTAB E0.3) CALL 

CALL TABUER ( lUERT ) 

DO 50 IHTAB-1.4 

CALL TABHOR ( IH0R2 ) 

LTR-64+IHTAB-^4*(lUTAB-l ) 

CALL ANCHO (LTR) 

CONTINUE 

CALL NEULINE 

CONTINUE 

CALL FINITT <0,0) 

END 



RSTTAB 
SETTAB 



(250,IHOR2) 
(150,IHOR2) 



A B 



E F 



H 



I J 



f1 N 



Screen Limits 



Figure 4.17 
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SETTING TEE 4.17.6 This routine sets the left and right margins to 

MARGINS: be used by Carriage Return (CARTN) , HOME, and NEWPAG (see 

Subroutine SETMRG Section 4.4). 

CALLING SEQUENCE: 

CALL SETMRG (MLEFT, MRIGHT) 

Parameters Entered: 

MLEFT - the screen coordinate at which a 

line of alphanumeric output starts. 
Its value should always be greater 
than and less than the maximum 
screen coordinate (1023 or 4095) or 
the right margin value. 

MRIGHT - the screen coordinate at which a 

line of A/N output ends. Its value 
should always be greater than MLEFT 
and less than the maximum screen 
coordinate (1023 or 4095). 

4.18 This routine returns the last date of modification 
Subroutine TCSLEV for the Terminal Control System as well as the level number, 

CALLING SEQUENCE: 

CALL TCSLEV (LEVEL) 
Parameter Returned: 

LEVEL - a three element integer array where: 

Level 1 = the year of modification. 
Level 2 = the Julian day. 
Level 3 = the level number. 
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IDENTIFYING THE 
4014/15 TERMINAL: 

Subroutine TERM 



5. ROUTINES WHICH SUPPORT THE 4014 or 4015 * TERMINAL 

The following routines specifically support the 4014 Display 
Terminal and the 4014/15 with the Enhanced Graphics Module.** 
The Terminal Control System is compatible in its entirety 
with the 4015/15 Terminal, but the special routines allow 
the Terminal to utilize its extra capabilities. 

The 4014/15 Enhanced Terminals have an addressable range of 
points from through 4095 on each axis, although its normal 
range is from through 1023 points. The address character 
sequences used by both address ranges are compatible with 
all TEKTRONIX Graphic Display Terminals; however, when using 
the 4096 range of addressable points on the 4006, 4010, 4012, 
or 4013 Terminals, the resolution is only to ever fourth 
address point. 

That a 4014 or a 4015 is being used, with or without the 
Enhanced Graphics Module, is specified by the first parameter 
of Subroutine TERM (Section 5.1). 

5.1 In order to take advantage of the extra features of 
the TEKTRONIX 4014/15 Terminal, the user must inform the 
Terminal Control System that he has the capability. He does 
this by specifying his Terminal with Subroutine TERM. If he 
does not use TERM before calling 4014/15 routines, the 
Terminal Control System will treat his Terminal as a 4010 or 
a 4012/13 Terminal. TERM needs to be called only once, 
however, after each initialization (i.e., call to INITT) . 

CALLING SEQUENCE: 

CALL TERM (ITERM, ISCAL) 

Parameters Entered: 

ITERM - an integer from to 3 where: 

- indicates 4006-1*** 

1 - indicates 4010, 4012/13 

2 - indicates 4014/15 

3 - indicates 4014/15 with 

Enhanced Graphics Module 
ISCAL - either 1024 (addressable points) 
or 4096 (addressable points) 



* The 4015 Terminal and 4013 Terminal offer an APL character set as well as the 
ASCII character set available on the 4014 and 4012 Terminals. The notation 4014/ 
15 refers to either the 4014 or the 4015 Terminal; the notation 4012/13 refers 
to either the 4012 or 4013 Terminal. 
** The Terminal Control System does not support Special Point Plotting for the 
Enhanced Graphics Module. 
*** Releases 3.0 to 3.3 of Terminal Control System may require modifications to 
BAKSP for 4006-1 operation. 
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MODIFYING THE ^'^ Vectors on the 4014 or 4015 Terminal cannot only vary 

Z-AXIS OF THE ^^ ^ ^'^^ ^ position; they also vary in brightness and storage 

40t4/l5 TERMINAL' properties. This type of variation is called the Z-axis 

capability. The 4014/15 Terminal has three Z-axis capabilities 

Subroutine CZAXIS 

Normal Z-Axis - This is the same storage tube mode which is 
available on the 4010 Terminal. The display 
is bright and sharp. It is also stored on 
the screen until it is erased by a call to 
NEWPAG or ERASE (Sections 4.4 and 4.12). 
Normal Z-axis is the default mode and is 
used at all times unless a call to CZAXIS 
is made. 

Defocused Z-Axis - This mode is in all respects similar to 
normal mode, except that the display is 
results in broader lines and is slightly 
brighter. 

Enabled Write Through Mode - This mode allows a stored 

display and refreshed information to coexist 
on the Terminal screen. For example, the 
user may wish to display a graph, yet add 
moving vectors to the original graph. These 
vectors must be refreshed. 

CALLING SEQUENCE: 

CALL CZAXIS (ICODE) 

Parameter Entered: 

ICODE - an integer from through 3 calls 
the Z-axis mode. 

- normal Z-axis 

1 - defocused Z-axis 

2 - enabled write-through mode 
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CHANGING THE 
CHARACTER SIZE 
ON THE 4014/15 
TERMINAL: 

Subroutine CHRSIZ 



5.3 The 4014/15 Terminal has four different available 
character sizes which range from a very small 133 characters 
per line size to a very large 74 characters per line size. 
CHRSIZ changes both the current character size and the 
variables associated with the change. The default size is 
size 1 (see below) . 



CALLING SEQUENCE: 

CALL CHRSIZ (ICHAR) 

Parameter Entered: 

ICHAR - an integer which has one of the 

following values representing the 
size of the characters. 



CHARACTER SIZE 


CHARACTERS/LINE 1 
74 


.INES/PAGE 


1 


35 


2 


81 


38 


3 


121 


58 


4 


133 


64 



MEASURING THE SIZE 
OF A CHARACTER: 

Subroutine CSIZE 



5.4 CSIZE provides the current character height and width 
in raster units. The characters are measured in the screen 
coordinate system in use, either 1024 or 4096. This sub- 
routine is useful for imposing alphanumeric characters on 
graphic displays, primarily in the case of labeling. It 
allows the user to see where his label ought to be placed 
to coincide with grid lines and tic marks. When dealing 
with the multiple character sizes available on the 4014 
Terminal, this routine is especially helpful. 



CALLING SEQUENCE: 

CALL CSIZE (IHORZ, IVERT) 



Parameters Returned: 
IHORZ 



the horizontal character dimension, 
including inter-character space; 
the horizontal distance between 
two periods. 



IVERT - the vertical distance, as above, 
including interline spacing. 

The following example demonstrates a use of CSIZE and 
CHRSIZ. Subroutine ANCHO (Section 4.3) is used to output 
the alphanumeric character. 
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C * DEMON SI RAT 1 0^J O? CHI.SI7. A^CL CSI?& 

CALL. IN ITT (30) 
C * USL A SUE-nOUlINk 10 DO IHL wOhK 

CALL lEHA ( 3> 10i:i^) 

CALL SUDl (0,400, 1) 

CALL SUEl (500,40M, ^) 

CALL SUBl (0,0,3) 

CALL SUlil (500,0,4) 

CALL PI MITT (0,0) 

C + ^UbhOUTIMP. 10 CHA^J'JE A\i D MLASUhL CHARACTER SIT-B 
C * AfvD R0SriI0r\J OUT PUT 

bUbnOUlINE SUDl ( I X, I Y, I CHDSZ ) 
C * Sfc.l UP THE MEbSAGE ARRAY 

DIMEXSIO>J IMSG (55) 

LAI A U-'SG /(I, 72, (b,H2, (bs (IsS^* f9,S2, 32,83, 73,90, f9, 
f^ 32, 73,63, 32, 0, 0, 32,88, 32, 0, 0, 32,84, f9, 75,80, 79, 73, 

<p^ 78,84,83,44, 0, 0, 32,88, 32, 0, 0, 32, 77, 73, 78, 73,80, 79, 

e< 73,78,84,83,46/ 

C * DRAW A box FOR OUT PUT 

CALL MOVAPS ( IX, lY) 

CALL DRlvREL (310,0) 

CALL DRW DEL (0,310) 

CALL DRwhEL (-310,0) 

CALL DRWREL (0,-310) 
C * SEl A\iD MEASURE CHARACTER SI7;e IN) 4096 SPACF 

CALL THRM (3,4 09 6) 

CALL CHRSI>^ (ICHRS^) 

CALL CSI7.E (HIORZ, I VERi ) 

I M SG ( 37 ) = I HO i\Z / 1 0+48 

IMSG( 38)=IH0R7-IH0R7/ 10* 10+48 

I M SG ( 4 2 ) = I V E R 1 / 1 0+ 48 

IN'SG(43)=I V'ERT-I \/ERT/10* 10+48 
C * SE'i AMD MEASURE CHARACTER SIZE INI 1024 SPACE. 

CALL TERM (3, 1024) 

CALL CHRSIZ. (ICHISZ) 

CALL CSIZE (IHORZ, I VERT ) 

IMSG( 19 )=IHORZ/10+48 

IMSG(20)=IHUR7.-IHOR7/ 10* 10+48 

I M SG ( 24 ) = I V Fh T/ 1 0+ 48 

I M SG ( 2 5 ) = I V ER T- I VER T / 1 0* 1 0+ 48 
C * F0SITI0^J AND PUT OUT MESSAGE 

CALL MOVABS (IX, I Y) 

CALL MOVREL (£0,200) 

DO 100 1= 1, 15 
100 CALL ANCHO (IMSG(I)) 

CALL ANCHO (ICHRSZ: + 48) 

I2LND>J=-2*I VERT 

CALL MOVREL (- 1 ^^^IHORZ, I 2L^n) D\' ) 

DO 200 1=16, 3 r 
200 CALL AiNJCHO (IMSG(I)) 

CALL MOVR.EL ( - 2 1* I HORZ, I 2LNJ DM ) 

DO 310 1 = 37, 55 
310 CALL AMCHO (IMSG(I)) 

RETURM 

END 
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CHARACTER SIZE 1 

IS 14 X aa TEKPOINTS' 

56 X 88 HINIPOINTS* 



CHARACTER SIZE B 

IS 13 X 21 TEKPOINTS 

51 X 83 niNIPOINTS 



CHARACTER SIZE 3 

IS J0d X 13 TEKPOINTS 

34. X 53 n INI POINTS 



CHftRACTER SIZE 4 

IS fiS X 12 TEKPOINTS. 

31 K 4A niNIPOXNTS 



Figure 5.4 

* TEKPOINTS means addressable points in 1024 x 1024 space; 

* MINIPOINTS means addressable points in 4096 x 4096 space 
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INCREMENTAL 
PLOTTING: 

Subroutine INCPLT 



5.5 INCPLT is used to perform incremental plotting. 
Each incremental plot character will move the beam one 
raster unit in the given direction. The user specified 
the direction, whether it is to be visible or invisible 
and whether he wishes this plot character to be output. 
The user must have a 4014 or 4015 with the Enhanced Graphics 
Module and have specified a 4096 grid in his call to TERM 
(Section 5.1). 



CALLING SEQUENCE: 

CALL INCPLT (lONOFF, IDIR, NO) 



Parameters Entered: 
lONOFF 



= Beam off (invisible) 

1 = Beam on (visible) 



IDIR 



Direction Code 



NO 



the number of times the plot 
character is to be repeated. 



Direction Code: 




Example: 



Figure 5.5 



CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
CALL 
END 



INITT ( 

TERM (3 

nO»-'AES 

INCPLT 

INCPLT 

INCPLT 

INCPLT 

INCPLT 

INCPLT 

INCPLT 

FINITT 



30) 

, 4096 ) 

K 200 . aoo ) 



(1,0 
(0.2 
(1,4 
CO. 1 



300) 
lOO) 
30C) 
100) 



C 1 . 6 . 300 ) 
(0.0. 100) 

( 1 . a . 300 ) 

(0,0) 



5-6 



4010A01 User 



CHECK TERMINAL 
MODES: 

Subroutine SEEMOD 



CHECK TERMINAL: 
Subroutine SEETRM 



5.6 SEEMOD returns the value of common variables indicating 
the status of the hardware dashed line type, Z-axis mode, 

and Terminal mode. (See Sections 3.12 and 5.2). 

CALLING SEQUENCE: 

CALL SEEMOD (LINE, IZAXIS, MODE) 

Parameters Returned: 

LINE - the hardware line type in effect 
IZAXIS- the hardware Z-axis mode 
MODE - the software mode: 

= alphanumeric 

1 - vector 

2 = point plot 

3 = incremental plot 

4 = dash 

5.7 SEETRM returns the common variables which identify 
terminal speed, type, character size, and the maximum 
range of addressable points (4096 or 1024) . 

CALLING SEQUENCE: 

CALL SEETRM (ISPEED, ITERM, ISIZE, MAXSR) 

Parameters Returned: 



ISPEED - the baud rate in characters per 
second which has been set in 
INITT (Section 2.1). 

ITERM - the terminal type set in TERM 
(Section 5.1) . 

ICSIZE - the character size set in CHRSIZ 
(Section 5.3) . 

MAXSR - the maximum screen address set 
in TERM (Section 5.1). 
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6 . TRANSFORMATIONS* 

The transformation routines in the Terminal Control System 
allow the user to define any of three coordinate systems; 
linear, logarithmic, or polar. The default transformation 
(LINTRN) is linear, and it remains in effect until one of 
the transformations is called. LINTRN returns the user to 
a linear window. 

The logarithmic transformation, LOGTRN, allows the user to 
express data as logarithms with reference to either the 
X or Y-axis or both. 

The polar transformation, POLTRN, allows the user to define 
his coordinates as radius and degrees. 

Each transformation occurs automatically before the drawing 
of a vector; each remains in effect until another transforma- 
tion routine is called or until the system is re-initialized. 

TRANSFORM: Alter the coordinate system in which data is 
specified. 

Example : 



POLTRN 



radius , angle 
X, Y 


10,0'' 
10,0 


10,90° 
0,10 


10,180° 
-10,0 



LINTRN 



Figure 6, produced by the following codes, draws a grid by 
means of a user-written subroutine, GRID**; this gridwork 
is displayed in five different coordinate systems. Grid (a) 
is linear. Grids (b) , (c) and (d) demonstrate the three 
different types of logarithmic transformations; respectively, 
they are (log-x, linear-y) , linear-x, log-y) and (log-x, 
log-y) . Grid (e) demonstrates a call to the polar trans- 
formation, POLTRN. All five grids use the same virtual 
data. The difference between them is the result of the 
transformation through which they are viewed. 



* The 4010A01 PLOT 10 Terminal Control System, System Manual explains how the user 
may write his own transformation routines by means of user hooks provided in 
internal routines of the package. 

** See page 55 for the coding of GRID. 



4010A01 User 



6-1 







CALL 


C 


* 


LEFINt 
CALL 


c 


* 


DF.FIXiF.. 
CALL 


c 


* 


DhAW A 
CALL 


c 


* 


LEFI>Jt 
CAI.L 
CALL 


c 


* 


LhAW A 
CALL 


c 


:*: 


rF.FI\^E 
CALL 
CALL 


c 


* 


FinAW A 
CALL 


c 


* 


LEPINE. 
CALL 
CALL 


c 


+ 


LhAW A 
CALL 


c 


* 


LEFUJE 
CALL 
CALL 


c 


* 


Li '.AW A 
I. ALL 
CALL 

t.M L 



I^]nT( 30) 

THE DATA WINDOW 

DWINLOC 10., 10P)., 10., 100. ) 

SChEFAi WIMDOW (A) 

1 w I :NJ DO ( 0, £ 50, 500,7 50) 

GEID SHOWINJG A LTJFiAL TEAM SF OEM AT I ON' 

GEID 

SChEEM WIMDOW CB) 

1WIMDO(0, 250, 0, 250) 

LOGIEMCI) 

GKID SHOWIMG A LOG-X, LIMEAE-Y TEA.N SFOEM AT I 0>J 

GEID 

SCEEF.N WINDOW (C) 

lwIMDO(7 50, 1000, 500, 7 50) 

LOGTEMCS) 

GEID SHOWIMG A LIMEAE-X, LOG-Y 1 EAMSF OR^^A^ I OM 

GRID 

SCEEEM WIMDOW (D) 

TW I M DO (7 50, 1000, 0,2 50) 

LOG TEN (3) 

GEID SHOWIMG A LOG-X, LOG-Y IRAiMSFOEMATI OM 

GEID 

SCREEN WIMDOW CE) 

TWIMDOC 375, 625, 250, 500) 

POLTEMC 10., 100., 0. ) 

GRID SHOWIMG A FOLAE T RAM SFOE^' AT I OM 

GI^ID 

FIMin C0, 0) 



6-2 @ 4010A01 User 



C * DRAW A GhID WITH LI^3^.S FRO^ 10 TO 100 AT INTERVALS OF 10 

SUBPiOUTIMK Gf.IlJ 

DMIN= 10. 

DKAX= 100. 

X=DMi:C 
C * DRAW GRID LINES ALO:\^G X-AXIS 

DO 100 I=l> 10 

CALL MOVEA(X> DNIM) 

CALL DP;AWSA(X^DMAX) 
100 X=X+10. 

Y= 10. 
C * DRAW GRID LIMLS ALCMG Y-AXIS 

DO 200 J= 1> 10 

CALL MOVEA(DMIM,Y) 

C AL L D RAW S A ( DM AX , Y ) 
200 Y=Y+10. 

RETURN 

END 



^HH ^imm HHIH ■«■■■ ■■■■ MMM ■■■■ MMMM Wmm 

■ma ■«>• B>» •-«M l»— • >l_ ■_». ■>«■ HMI 

m^ >■« aaiiaii ■>— i >^ >_i_i aai— ■ _ lam 
■MB MHi HBB anM UMai ■«■ ^iM ■»• anal 

— JL— JL— Li— ii I _ ._ ■_ 



"•" ^™ ^^ -"■ "~" ■— - -"■ ■— " — ^ 
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(c) 



(e) 



II ill I— JL— aaa i^ ■_ •> M 



(b) 



Figure 6 



(d) 
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THE LINEAR 
TRANSFORMATION: 

Subroutine LINTRN 



6.1 LINTRN returns a user from either a logarithmic or 
a polar window and establishes linear scaling. A linear 
window is assumed for all Terminal Control System routines 
until log or polar definitions are requested; it is, 
therefore, not necessary to call LINTRN upon initializing 
a program. 

CALLING SEQUENCE: 
CALL LINTRN 



THE LOGARITHMIC 
TRANSFORMATION: 

Subroutine LOGTRN 



6.2 LOGTRN defines either the X or Y axis or both as 
logarithmically scaled to fit the user's screen window. 
The extent of the logarithmic definition is determined by 
the parameter KEY. 



NOTE 

If the current data window limits are not positive for an 
axis defined as Zogarithnio ^ that axis will be reset to 
lineojr to avoid an invalid transformation. 



THE POLAR 
TRANSFORMATION: 

Subroutine POLTRN 



CALLING SEQUENCE: 

CALL LOGTRN (KEY) 

Parameter Entered: 

KEY - 1 - X-axis logarithmic 
y-axis linear 

2 - X-axis linear 

y-axis logarithmic 

3 - X-axis logarithmic 

y-axis logarithmic 

6.3 POLTRN allows the user to define his virtual graphic 
data to the Terminal Control System in polar coordinates. 
Polar coordinates are specified by radius and angle. The 
angle is represented in degrees, counter-clockwise from a 
horizontal line to the right of the origin. The arguments 
of POLTRN control the shape of the screen window in which 
the virtual data is displayed. The virtual window is 
scaled and transformed to fit into the screen area between 
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arguments ANGMIN and ANGMAX. The third argument, RSUPRS, is 
subtracted from the virtual radius. If ANGMIN and ANGMAX do 
not equal the data window (DWINDOO minimum and maximum (YMIN 
and YMAX) , or if RSUPRS is not equal to zero , a distortion 
of the virtual polar data will occur (see Figures 6.7 and 
6.8). The user can adapt this distortion to emphasize any 
features he wishes. The polar origin is automatically 
located to obtain the largest possible display area within 
the user's screen window. 



CALLING SEQUENCE: 

CALL POLTRN (ANGMIN, ANGMAX, RSUPRS) 
Parameters Entered: 



DRAWING SEGMENTS 
USING THE POLAR 
TRANSFORMATION: 

Subroutine DRAWSA 
Subroutine DRAWSR 



ANGMIN - the minimum angle relative to the 
horizontal from which the display 
will appear on the screen. 

ANGMAX - the maximum angle relative to the 
horizontal from which the display 
will appear on the screen. 

RSUPRS - the radius suppression factor. 

6.4 In order to draw the grid used in (e) of Figure 6, 
a call to Subroutine DRAWSA was used in the construction 
of GRID. This call was substituted for a call to DRAWA 
(Section 3.5). DRAWSA is analogous to DRAWA, except that 
it enables the user to draw the curved line segments that 
are necessary when a polar transformation is in effect. 
Subroutine DRAWSR is analogous to DRAWR (Section 3.6), but 
again it is used for a polar transformation. 

CALLING SEQUENCE: 

CALL DRAWSA (X, Y) 

Where X and Y are the virtual 
coordinates to which the line 
segments are drawn. 

CALL DRAWSR (X, Y) 

Where X and Y are the virtual 
coordinates relative to the 
current beam position. 
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DRAWING DASHED 
LINE SEGMENTS 
USING THE POLAR 
TRANSFORMATION: 

Subroutine DASHSA 
Subroutine DASHSR 



6.5 DASHSA and DASHSR are analogous to Subroutines 
DASHA and DASHR (Section 3.11), respectively. They too 
are used for a polar transformation. 

CALLING SEQUENCES: 

CALL DASHSA (X, Y, L) 

Where X and Y are the virtual 
coordinates to which the dashed 
line segment is to be drawn. 
L is the dashed line type 
(see Section 3.12). 

CALL DASHSR (X, Y, L) 

Where X and Y are the virtual 
coordinates to which the dashed 
line is drawn relative to the 
current beam position. L is the 
dashed line type. (See Section 3.12) 



SCREEN GRAPHICS 
(Integer Arguments) 



VIRTUAL GRAPHICS 
(Real Arguments) 



ACTION 


ABSOLUTE 


RELATIVE 


ABSOLUTE 


RELATIVE 


MOVE 


MOVABS 


MOVREL 


MOVEA 


MOVER 


DRAW 


DRWABS 


DRWREL 


DRAW A 


DRAWR 


POINT 


PNTABS 


PNTREL 


POINTA 


POINTR 


DASH 


DSHABS 


DSHREL 


DASHA 


DASHR 


SEGMENTED 










DRAW 


none 


none 


DRAWS A 


DRAWSR 


SEGMENTED 










DASH 


none 


none 


DASHSA 


DASHSR 













TERMINAL CONTROL SYSTEM 

DRAWING ROUTINES 
Figure 6.5 
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USim THE POLAR 
TRANSFORMATION: 



6.6 Given the polar grid* (e) of Figure 6, examine the 
capabilities of Subroutine POLTRN; the first example demon- 
strates a dashed line segment which connects thirty different 
radii, with lengths between 90. and 100., at increments 
of three degrees; they are displayed between an ANGMIN of 
10° and an ANGMAX of 100°. Radius suppression is 0. 



C * 



C * 



C * 



10 



DIMENSION iiDATA(30) 

LATA RDATA /9 0. 3> 9 2. 4, 9-^. 5> 9 5. 2> 9 6« U 9 6. 9, 98 • 2, 98 
& 99.7, 100.0,99. 5>99. 0>98. b>98. 0>97. 5>9 7.0,9 6. 5,9 6 
& 9-^.0,9 3. 0,9 2. 0,9 3. 0,9 7. 0,9^. 3,9 1.0,92.8/ 

CALL IMITT (30) 
DEFINE THE lERMINA-L WINDOW 

CALL IWIN DOC 100,9 00, 100> f 00) 
DEFINE THE DATA WINDOW WITH RADIUS FROM 10 TO 100 

CALL DWINDOC 10., 100., 10., 100. ) 
SPECIFY A POLAR WINDOW DISPLAYED 



99. 

95. 



1,99. ^, 

5,9 5.0, 



BETWEEN 10 AND 100 DEGREES 



WITH RADIUS SUPPRESSION OF ZERO 

CALL POLTRN ( 10., 100., 0. ) 
DRAW A GRID SHOWING THE WINDOW 

CALL GRID 
PLOT THE DATA STEPPING IKE ANGLE FROM 10 10 100 DEGREES 
WITH INCREMENT OF 3 

CALL MOVEACRDATAC 1), 10. ) 

DO 10 1=1,30 

DEGREE= 10+1*3 

CAi.T. DASHSACRDATAri ),DEGRFB, 12) 

r./LL h I -l IK ( , ^'■') 



* See page 6-3 for the coding of 
Subroutine GRID. 




Figure 6.6 
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The second example demonstrates how the same plot 
would look if it were displayed with a virtual (data) 
window with a radius between 90. and 100. Again the radius 
suppression is 0. Notice that all grid lines specified 
below 90. are clipped. 



C * 



C * 



C * 



10 



CALL 

LEF'IME 
CALL 

LEHTxIt 
CALL 

SPECI hY 



INI TT C3C) * 

THE TEf^^1I^JAL WINDOW 
TW I N DO ( 1 C!> 9 0> 1 0> 6 00 ) 

THE DATA WINDOW WITH EADI US FFiOM 90 TO 100 
DWINDOC90.> 100.> 10.> 100. ) 
A POLAR WINDOW DISPLAYED BETWEEN 10 AND 100 DEGF^EES 



WITH RADIUS SUPPRESSION OP ZERO 

CALL POLTRNC 10.> 100.* 0. ) 
DRAW A GRID SHOWING THE WINDOW 

CALL GRID 
PLOT THE DATA STEPPING THE A.NGLE PROM 10 TO 100 DEGREES 
WITH INCRn:CJT Of 3 

CALL MOV/EACRDATAC 1)> 10. ) 

DO 10 I=l>30 

DEGHEE= 10-H*3 

CALL DASHSACRDATAC I )>DEGREE> 12) 

CALL I'INm(0, 0) 

S i P 

B.,N D 




Figure 6.7 



* The data and dimension statement which 
precede INITT are the same as those of 
Figure 6.6. 
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The third example, using the same data points and 
the same virtual (data) window as those of example 2 
(Figure 6.7), demonstrates how the graph is displayed with 
a radius suppression factor of 90. from each of the thirty 
radii, causing the data to be displayed between an ANGMIN 
of 10° and an ANGMAX of 100° and between a radius minimum 
of and maximum of 10. 







CALL 


c 


* 


DEFINE 
CALL 


c 


* 


DEFINE 
CALL 


c 


* 


SPECIFY 


c 


* 


W I TH RA 



IMITT (30) * 

THE TER^IINAL WINDOW 

TWINDOC 100,900* 100:» 600) 

IHE DATA WINDOW WITH RADIUS FROM 90 TO 100 

DWINDO(90.* 100. > 10. > 100. ) 

A POLAR WINDOW DISPLAYED BETWEEN 10 AND 100 DEGREES 
DIUS SUPPRESSION OF 90 
CALL POLTHNC 10. > 100.^9 0. ) 
C * DRAW A GRID SHOWING THE WINDOW 

CALL GRID 
C * PLOT THE DATA STEPPI^JG THE ANGLE 
C * WITH INCREMENT OF 3 

CALL MOVEACRDATAC 1)> 10. ) 

DO 10 I=U30 

DEGREE^ 10+1*3 

CALL DASHSACRDATACI )>DEGREE> 12) 

CALL FINITT(0, 0) 

STOP 

EN D 



IP 



FROK 10 TO 100 DEGREES 




Figure 6.8 



* See note, page 6-8. 
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The fourth example uses the same information as 
example 3. In this case, however, the polar window is 
displayed between an MGMIN of 0° and an ANGMAX of 180°, 
Radius suppression is again 90. 



C * 



C * 



C * 



10 



CALL INfl'IT (30)* 

DEFINE THE T£.I;MIMAL WIlNJDOW 

CALL TWINDOC 100>90fl> 100> ^00) 
DEFINE THE DATA WINDOW WITH RADIUS FROM 90 TO 100 

CALL DWINDO(90-> 100.> 10.* 100. ) 
SPECIFY A POLAR WINDOW DISPLAYED BETWEEN ZERO AND 180 DEGREES 
WITH RADIUS SUPPRESSION OF 90 

CA-LL POLTRN(0.* 180.>90. ) 
DRAW A GRID SHOWING THE WINDOW 

CALL GRID 
PLOT THE DATA STEPPING THE ANGLE 
WITH INCRF_MENT OF 3 

CALL MOVEACRDATAC 1)> 10. ) 

DO 10 1=1,30 

DEGREE= 10+1*3 

CALL DASHSA(RDATA( I ), DEGREE, 1 i^ ) 

CALL FINITT(0, 0) 

STOP 

EN 1.' 



FROM 10 TO 100 DEGREES 




Figure 6.9 



* See note, page 6-8. 
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7. INPUT/OUTPUT ROUTINES 

The user's program may perform three types of Input/Output 
with Terminal Control System subroutines: graphic, alpha- 
numeric, and Terminal/peripheral control. All the output 
from the package routines is funnelled through the basic 
subroutine, TOUTST, while all input comes in through sub- 
routine TINSTR. The graphic and control I/O use these two 
subroutines directly as well as their single character 
counterparts, TOUPT and TINPUT. Alphanumeric I/O can be 
accomplished through the more versatile set of routines 
described below. The user should be aware that some of 
the following routines may be implementation dependent (see 
Implementation Notes). 

For output the Terminal Control System translates all 
characters to be sent to the Terminal into ASCII decimal 
equivalent (ADE)* form and packs them into an output buffer. 
When the buffer is full or the system or user calls sub- 
routine TSEND, this buffer is dumped, translated into system 
dependent code, and sent to the Terminal. 

For input the Terminal Control System accepts system dependen 
code received from the Terminal, translates it into ADE* 

(see above) form, and distributes it to the subroutine 
which called for it, if necessary translating it again into 
alphanumeric format. 

From the point of view of the user's program, alphanumeric 
I/O may be accomplished more efficiently using direct 
methods, such as FORTRAN READ and WRITE statements. However, 
output through the Terminal Control System updates the 
graphic beam position, except where noted, and allows control 
over the exact positioning of characters anywhere on the 
Terminal screen, while input through the Terminal Control 
System provides correct formatting of data for later output 
or internal processing. It is the user's responsibility 
to call ANMODE to dump the output buffer before doing 
FORTRAN I/O. (See RECOVR, Section 4.11). Positioning of 
mixed FORTRAN and Terminal Control System output is 
implementation dependent. See Section 7.11.1 for details. 



* ADE code is simply the integer representation of the ASCII character set. The 
ADE characters are the numbers from to 127, with 48 representing 0, 65 "A", 
90 "Z", etc. 
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OUTPUT: 
Subroutine TOUTST 



Subroutine 
TOUTPT 



Subroutine 
ANCHO 



Three formats are allowed for both input and output : 

1. ADE (ASCII decimal equivalents)** 

2. Al (where Al represents one word with one 
alphanumeric character in it) 

3. Am (where Am represents one word with m 
alphanumeric characters in it. M is usually 
the number of alphanumeric characters that 
one word can contain) 

7.1 TOUTST outputs an array of ADE* characters. This 
routine does not update the graphic beam position within 
the Terminal Control System, nor does it put the Terminal 
in alphanumeric mode. TOUTST should be used only when 
outputting control characters which are not otherwise 
handled by the Terminal Control System. 

CALLING SEQUENCE: 

CALL TOUTST (NCHAR, lARRAY) 

Parameters Entered: 



NCHAR 



lARRAY 



the length of lARRAY, i.e., the 
number of characters to be output. 

the array containing ADE characters 
to be output. 



7.2 TOUTPT outputs a single ADE* character. This 
routine does not update the graphic beam position within 
the Terminal Control System, nor does it put the Terminal 
into alphanumeric mode. TOUTPT should be used only when 
outputting a control character which is not otherwise 
handled by the Terminal Control System. 

CALLING SEQUENCE: 

CALL TOUTPT (ICHAR) 

Parameter Entered: 



ICHAR 



an ADE* character to be output. 



7.3 ANCHO outputs a single ADE* character. This routine 
places the Terminal in alphanumeric mode, outputs the 
character, and then updates the position of the beam. For 
a complete description of ANCHO see Section 4.3. 



* ADE code is simply the integer representation of the ASCII character set. The 
ADE characters are the numbers from to 127, with 48 representing 0, 65"A", 
90 "Z", etc. 

** An ASCII decimal equivalent chart may be found at the end of this manual. 
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CALLING SEQUENCE: 

CALL ANCHO (ICHAR) 

Parameter Entered: 

ICHAR the non-control ADE character 
to be output. 

Subvout-lne 7.4 ANSTR accomplishes the same function as ANCHO, except 

ANSTR that it outputs an array of non-control ADE characters. 

ANSTR also places the Terminal in alphanumeric mode and 
updates the graphic beam position within the Terminal 
Control System. For complete description of ANSTR see 
Sections 4.3 and 4.3.1. 

CALLING SEQUENCE: 

CALL ANSTR (NCHAR, lARRAY) 

Parameters entered: 

NCHAR the number of characters to 
be output. 

lARRAY the array containing the ASCII 
decimal integer equivalents 
for the characters to be output 

Siibrout-ine 7.5 AlOUT outputs an array of Al FORTRAN format characters. 

AlOUT This routine puts the Terminal in alphanumeric mode and 

updates the graphic beam position in the Terminal Control 

System. 

CALLING SEQUENCE: 

CALL AlOUT (NCHAR, lARRAY 

Parameters Entered: 

NCHAR the length of lARRAY; the 
number of characters to be 
output . 

lARRAY the array of Al FORTRAN format 
characters to be output. 

Subroutine 7.6 AOUTST outputs an array of Am format characters. In 

AOUTST this format m represents the number of alphanumeric charac- 

ters in one word. This routine also updates the graphic 
beam position in the Terminal Control System. 
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CALLING SEQUENCE: 

CALL AOUTST (NCHAR, lARRAY) 

Parameters Entered: 

NCHAR the number of characters to 

be output, m times the length 
(number of words) of lARRAY. 

lARRAY the array of Am format characters 
to be output. If lARRAY is 
shorter than NCHAR, it is padded 
with blanks. 

INPUT: 7.7 TINSTR accepts input from the Terminal and puts it 

, . ^ ^ ^^ into an ADE array. These character- are in a form ready 

buDTOUt^ne lll^blh ^^ ^^ output by ANCHO (Sections 4.3) or ANSTR (Section 4.3.1), 

CALLING SEQUENCE: 

CALL TINSTR (LEN, lARRAY) 

Parameter Entered: 

LEN the number of characters 

expected. If fewer than LEN 
are received, lARRAY is padded 
with blanks, and if more than 
LEN are received, the next 
call to TINSTR will input the 
excess characters. 

Parameter Returned: 

lARRAY the ADE array into which the 
input characters are placed. 

Subvoutine TINPUT 7.8 TINPUT accepts one ADE character from the Terminal. 

CALLING SEQUENCE: 

CALL TINPUT (ICHAR) 

Parameter Returned: 

ICHAR the ADE character received from 
the Terminal. Since TINPUT 
calls TINSTR, a null record 
(entering only a carriage return 
at the Terminal) becomes a 
blank, while more than one 
character entered is stored for 
later access by any call to 
TINSTR. 
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Subroutine AlIN 7.9 AlIN accepts an array of characters from the Terminal 

in integer Al FORTRAN format. The array is in the correct 
format to be output by subroutine AlOUT (Section 7.5) 

CALLING SEQUENCE: 

CALL AlIN (NCHAR, lARRAY) 

Parameter Entered: 

NCHAR the number of characters expected 
from the TeVminal. Since AlIN 
calls TINSTR (Section 7.7) if 
fewer than NCHAR characters are 
received, lARRAY is padded with 
blanks; if more characters than 
NCHAR are received, they are 
stored for later access by any 
call to TINSTR. 

Parameter Returned: 

lARRAY the array in which the Al format 
characters are placed. 

Subroutine AINST 7.10 AINST accepts an array of characters from the 

Terminal in Am format. This array can then be output by 
subroutine AOUTST (Section 7.6). 

CALLING SEQUENCE: 

CALL AINST (NCHAR, lARRAY) 

Parameter Entered: 

NCHAR the number of characters expected 
from the Terminal. Since AINST 
calls TINSTR (Section 7.7), if 
fewer than NCHAR characters are 
received, lARRAY is padded with 
blanks; if more than NCHAR are 
received, they are stored for 
later access by any call to TINSTR. 

Parameters Received: 

lARRAY the array in which the Am format 
characters are placed. 
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utility I/O 
Routines 



Setting the 
Output Buffer 
Format : 

Subroutine SETBVF 



7.11 The following routines aid the user of the Terminal 
Control System in outputting or inputting data. These 
routines, however, should be used carefully and in most 
cases will not need to be called. 

7.11.1 The user will find it necessary to control his 
output format after implementation of the package only 
when changing to a different Terminal type (e.g., from a 
4010 to a 4014) or when transferring to a different 
computer system. The output format must be changed in 
these cases in order to avoid interline character problems 
(see the Implementation Notes). Interline characters, 
particularly carriage return (CR) , line feed (LF) , and 
timing characters (NUL or SYN) , need to be suppressed to 
make graphic input possible. If the user's implementation 
doesn't suppress interline characters, the user will need 
to call SETBUF as well as TERM when chaging from a 4010 or 
4012 Terminal to a 4014 Terminal. 

CALLING SEQUENCE: 

CALL SETBUF (KFORM) 

Parameter Entered: 

KFORM the format of the output buffer, after 
the following code:* 

1 - For 4010 and 4012 Terminals. This 
format is for systems on which interline 
characters cannot be suppressed. 
Characters necessary to generate a move 
back to the current beam position are 
stored at the beginning of each buffer. 
Graphic cursor input is not possible. 
With buffer Type 1, the move back to the 
current stored beam position happens 
before every Terminal Control System 
buffer output. For example, CALL CHRSIZ 
(2). CALL ANMODE moves the alphanumeric 
cursor to the location at which it was 
after the previous buffer was transmitted, 
The subsequent system-supplied interline 
characters may move the cursor to the 
left and down one line, so any non- 
Terminal Control System output that 
follows will begin there. 



The following discussion is important for users who: 

(a) Wish to mix Terminal Control System output with other types of output 
(e.g., FORTRAN). 

(b) Wish to run programs on different computer systems, or 

(c) Wish to change Terminal types (e.g., from a 4012 to a 4014 Terminal). 
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2 - For 4014 Terminals. This format 

is for systems on which interline 
characters cannot be suppressed. Thus 
interline characters follow each out- 
put buffer transmission to the Terminal. 
However, a flag character (ESC) is sent 
where necessary, and the 4014 hardware 
ignores the interline characters. G raph i 
cursor input is possible . In all other 
respects Buffer Types 1 and 2 are identi- 
cal , including their behavior when non- 
Terminal Control System output is mixed 
with Terminal Control System output . 

3 - Used for all Terminals on systems 

where interline characters may be 
suppressed. Graphic cursor input is 
possible . With Buffer Type 3, no 
carriage returns or other interline 
characters are appended to Terminal 
Control System output by the computer. 
All output begins at the position of 
the alphanumeric or graphic cursor on 
the Terminal screen. This position 
agrees with the stored beam position 
even after ANMODE or TSEND is called. 
However, non-Terminal Control System 
output causes a discrepancy between 
the stored and the actual beam position. 

4 - Like Buffer Type 3, except that 

output is unbuffered; i.e., each call 
to TOUTST results in direct output. 



Example : 

A program follows to illustrate the Buffer Type dependent 
results that occur when FORTRAN and Terminal Control System 
output are mixed . 

NOTE 

Buffer types I and 2 are not available 
in the ISO version of the Terminal 
Control System. 
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DIMENSION ITHE(l) 

DATA ITHE/5HTHE / 

CALL INITTOia) 

CALL SETBUF(2) 

CALL TERM(3,1024) 

CALL CHRSIZ(l) 

CALL MOVABS( 0,450) 

CALL DRWABS(100,450) 

CALL ANMODE 

WRITE(5,100) 
100 F0RMAT(1X,9HTEKTR0NIX) 

CALL CHRSIZ(2) 

CALL ANMODE 

WRITE(5,200) 
200 F0RMAT(1X,15H 4014) 

CALL CHRSIZ(3) 

CALL A0UTST(5,ITHE) 

CALL FINITT(0,200) 

END 

Results with Buffer Types 1 and 2: 



TWE 



TEKTRONIX 4^1^ 
Results with Buffer Types 3 and 4: 



TEKTRONIX 

THE 4014 



On this computer system, the FORTRAN WRITE carriage 
control character "space" (IX) results in a line feed 
(LF) before FORTRAN output and a carriage return (CR) 
after output. A carriage return and a line feed follow 
each Terminal Control System output. On your computer 
system results of this program may differ from those 
shown due to different carriage control characters. 
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Detailed Explanation of the Example: 



PROGRAM STEP 
MOVABS (0,450) 


PLACEMENT 


OF OUTPUT 


Buffer Type 1 and 2 


Buffer Type 3 and 4 


Interline characters 


The line feed 


DRWABS (100,450) 


following ANMODE and 


preceding "TEKTRONIX" 


ANMODE 


the LF preceding 


places it one line 


WRITE "TEKTRONIX" 


"TEKTRONIX" place 
"TEKTRONIX" two lines 


below (100,450). 


CHRSIZ (2) 


below (100,450). 




The software MOVE to 


The CR following 


ANMODE 


(100,450) and similar 


"TEKTRONIX" and the 


WRITE "4014" 


carriage control 


LF preceding "4014" 




characters to the 


place "4014" beginning 




above place 


at the left margin two 




"TEKTRONIX" and 


lines below (100,450). 




"4014" on the same 




CHRSIZ (3) 


line. 




The software MOVE to 


The CR following "4014" 


AOUTST (5,ITHE) 


(100,450 places 


places "THE" on the 


FINITT 


"THE" there. 


same line as "4014" but 
at the left margin. 
NOTE: The software 
assumes the cursor 
position to agree with 
the stored beam position. 
No MOVE to the stored 
beam position occurs. 
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Examine the 7.11.2 SEEBUF allows the user to examine the format of 

Output Format: his output buffer (see SETBUF, Section 7.11.1). 

Subroutine SEEBVF ^^^^^^ ^^^^^^^^^ 

CALL SEEBUF (JFORM) 

Parameter Returned: 

JFORM the output buffer format presently 

in use. For a 4010 or 4012 Terminal 
JFORM should return either 1 (for 
systems which do not allow interline 
characters to be suppressed) 3, or 
4 (for systems where interline charac- 
ters may be suppressed) . For a 4014 
Terminal JFORM should return 2 , 3 or 4 , 

Examining the 7.11.3 LEFTIO returns the number of characters remaining 

Useahte Spaoe in the Input buffer on the amount of space (in characters) 

in the Input remaining in the Output buffer. In cases where the amount 

or Output Buffer: of input is variable, for example, the user may wish to 

. - see how many characters need to be processed before a 

given input. 

CALLING SEQUENCE: 

K=LEFTIO (IBUFF) 

Parameter Entered: 

IBUFF indicates which buffer is to be 
examined . 

1 Input buffer 
Output buffer 

Parameter Returned : 

K the number of characters left in 
the buffer indicated by IBUFF. 
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Looating the 
Position of the 
Graphic Beam: 

Subroutine SEELOC 



Dumping the 
Output Buffer: 

Subroutine TSEND 



7.11.4 SEELOC allows the user to locate on the screen 
the last position of the graphic beam if he has generated 
output outside the Terminal Control System (e.g., a FORTRAN 
READ or WRITE or a call to TOUTST or TOUTPT (Sections 7.1 
and 7.2, respectively). Thus, he may update the beam 
position himself. 

CALLING SEQUENCE: 

CALL SEELOC (IX, lY) 
Parameters Returned : 

IX the screen X-coordinate of the beam. 

lY the screen Y-coordinate of the beam. 

7.12 TSEND dumps the output buffer constructed by the 
Terminal Control System output routines. Whenever the 
output buffer becomes full, it is transmitted; but TSEND 
may be called any time the user wishes to have all stored 
output displayed. (It is customary to call ANMODE, as 
TSEND may leave the Terminal in graphics mode.) 

The positioning on the Terminal screen of non-Terminal 
Control System output (such as a FORTRAN WRITE) is 
dependent upon the way in which the software package is 
implemented on your computer. See Section 7.11.1 for 
details. If all output is through the Terminal Control 
System, no such implementation dependencies exist. 

CALLING SEQUENCE: 

CALL TSEND 
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APPENDIX A 



I. An Advanced Use of the Terminal Control System: 

Circuit Drawing A2 

II. Terminal Control System 

Common Variables ....... A7 

III. Glossary A9 
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The combination of simple Terminal Control System routines 
can result in sophisticates usages. The following example 
demonstrates how the graphic cursor can be used in combina- 
tion with simple moves and draws to create electrical 
circuit drawings interactively. 

The main program calls the virtual cursor. The user can 
position it anywhere on the screen and, by punch different 
Terminal keys, move and draw or call subroutines which 
draw symbols at that position. 

C « PROGRAM TO DRAU CIRCUITS INTERACTIUELV 

DATA IDRAU/SS/, in0t»E/77/, IERASE.^69/ , IQUIT/81/, IHCOPV/72/ 
DATA IRESIS/82X, ICAP/67/, ITRANS/84/, IGRND/71/ 
CALL INITTC30) 
C « SET TERMINAL SCREEN UINDOU 

CALL TUINDOCO, 1000. 0,750) 
C * SET UIRTUAL SPACE DATA UINDOU 
CALL DUINDO(0. .500 ,0. .375. ) 
CALL nOUEA(0. .0. ) 
C * CALL FOR THE GRAPHIC CURSOR 
100 XFROM-XTO 

YFROn-YTO 
105 CALL UCURSR(KEY.XTO,YTO) 

IF (KEY NE IDRAU)GO TO 110 

CALL DRAUA(XTO.VTO) 

GO TO 100 
lie IF r KEY NE IMOUE )G0 TO 120 

CALL nOUEA(XTO.YTO) 

GO TO IOC 
lao IF r KEY NE . IERASE)GO TO 130 

CALL ERASE 

GO TO 105 
130 IF f KEY ME IQUIT)GO TO 140 

CALL FINITT(0,0) 
140 IF r KEY NE IHCOPY )G0 TO 150 

CALL HDCOPY 

GO TO 105 
C * DETERMINE ROTATION OF SYMBOL 
150 RANGLE-ATAN2( YTO-YFROM, XTO-XFROM )*57 . 2957795131 

CALL RROTATCR ANGLE) 

IF(KEY NE IRESIS)GO TO 160 

CALL RESIST 

CALL DRAUACXTO.YTO) 

GO TO 100 
160 IF (KEY NE ICAP )G0 TO 170 

CALL CAP 

CALL DRAUA(XTO>YTO) 

GO TO 100 
170 IF(KEY NE. ITRANS)GO TO 130 

CALL TRANS 

CALL MOUEA(XFROM.YFROM) 
C * BEAM LEFT AT START POINT FOR TRANSISTOR 

GO TO 105 
180 IF t KEY NE IGRND )G0 TO 100 

CALL GROUND 

ChLL MOUEA(XFROM-YFROM) 
C t: BEAM LEFT AT START POINT FOR GROUND SYMBOL 

GO TO 105 

END 

(a) 4010A01 User 



The subprograms draw four different symbols: 

Symbol Keyboard Character 

register R 

capacitor C 

transistor T 

ground G 



t ROUTINE TO DRAU A RESISTOR 
SUBROUTINE RESIST 



CALL 

CALL 

CALL 

CALL 

CALL 

CALL 

CALL 

CALL 

RETURN 

END 



DRAURdO 

DRAURO 

DRAURce 

DRAURce 

DRAURce 

DRAURi.6 

DRAWRce. 

DRAURO 



.0 
10 

-ao 

20 
-20 
20 
-20 

10 



-AA/V- 



C * SUBROUTINE TO DRAU 
SUBROUTINE CAP 



A CAPACITOR 



CALL 

CALL 

CALL 

ChLL 

CALL 

CALL 

RETURN 

END 



DRAURt 10 

noUER(0 

DRAUR(0 

nOUER(10 

DRAUR ( 

nOUER(0 



,0, 
20. 
-40 
,40 
-40 
20 



C * ROUTINE TO DRAU A TRANSISTOR 
SUBROUTINE TRANS 
CALL DRAUR (20 .0 ) 
CALL DRAUR(0. . 20 ) 
CALL DRAUR (2 ,0 ) 
CALL DRAUR (0 ,-40 ) 
CALL DRAUR(-2. ,0^ 
CALL DRAUR <0 , 20 . ) 
CALL n0UER<;2. , 10 ) 
CALL DRAUR (20 , 20 ) 
CALL noUER(-20 ,-40. ) 



CALL DRAURdS. ,-15 
CALL DRAUR(2 ,2 ) 
CALL DRAURO , -7 . ) 
CALL DRAUR (-7 O. ) 
CALL DRAUR<2. ,2 ) 
CALL n0UER(5. , -5 . ) 
RETURN 

Erm 



) 
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C X ROUTINE TO DRAU A GROUND SYMBOL 
SUBROUTINE GROUND 
CALL DRf^URClO .0 ) 
CALL nOUERCO. ,-16. ) 
CALL DRAURCO , 3S . ) 

CALL NOUERCS ,-37. ) L 

CALL DRAURCO ,2B. ) "ZZ 

CALL nOUERCS ,-17. ) 

CALL DRAURCO. , 18 . ) 

CALL MOUERCS. , -7 ) 

CALL DRAURCO ,3. ) 

RETURN 

END 



Examples of circuits which can be drawn using the 
above program: 




A transistor amplifier 
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A logic gate 
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II. TERMINAL CONTROL SYSTEM COMMON VARIABLES 



All functions and subroutines which required users of earliest releases (Release 
2.0 and 2.1) of the Terminal Control System to access the /TKTRNX/ common area 
are now supported by routines; therefore, conversion of programs which used earliest 
releases TCS is fairly simple. The conversion consists of deleting the /TKTRNX/ 
common area from these programs and changing the code lines which set the common 
variables, so that the appropriate subroutines are called, as follows: 

Variables in /TKTRNX/ common Subroutines in Release 3 or Level 1 

TRSINF, TRCOSF RROTAT 

TRSCAL RSCALE 

KLMRGN, KRMRGN SETMRG 

The tab routines are now somewhat different that in earliest versions (Release 
2.0 or 2.1) in that no tab tables are provided in the common area. The user 
must insert a dimension statement for KHORZT and KVERTT in his older programs 
using the tab routines. 

A list of TCS common variables follows. 
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VARIABLE NAMES IN ALPHABETICAL ORDER 



Name 

KBAUDR 

KBEAMX 

KBEAMY 

KDASHT 

KEYCON 

KFACTR 

KGNFLG 

KGRAFL 

KHOMEY 

KHORSZ 

KINLFT 

KKMODE 

KLINE 

KLMRGN 

KMAXSX 

KMAXSY 

KMINSX 

KMINSY 

KMOFLG 

KMOVEF 

KOTLFT 

KPAD2 

KPCHAR 

KRMRGN 

KSIZEF 

KTBLSZ 

KTERM 

KUNIT 

KVERSZ 

KZAXIS 

TIMAGX 

TIMAGY 

TMAXVX 

TMAXVY 

TMINVX 

TMINVY 

TRCOSF 

TREALX 

TREALY 

TRFACX 

TRFACY 

TRPARl 



Use 

General 

Screen Graphics 

Screen Graphics 

Virtual Graphics 

Virtual Graphics 

Screen Graphics 

General 

General 

General 

A/N 

I/O 

General 

Graphics 

A/N 

Virtual Graphics 

Virtual Graphics 

Virtual Graphics 

Virtual Graphics 

Unused 

Screen Graphics 

I/O 

General 

Screen Graphics 

A/N 

A/N 

A/N 

General 

I/O 

A/N 

General 

Virtual Graphics 

Virtual Graphics 

Virtual Graphics 

Virtual Graphics 

Virtual Graphics 

Virtual Graphics 

Virtual Graphics 

Virtual Graphics 

Virtual Graphics 

Virtual Graphics 

Virtual Graphics 

Virtual Graphics 



Description 

Characters per Second 

Beam X-coordinate 

Beam Y-coordinate 

Dash Specification 

Transformation Key 

Addressing Factor 

General Error Flag 

Graphic Level Flag 

Home Y-Value 

Character Horizontal Size 

Characters Left in Input Buffer 

Mode 

Vector Type 

Left Margin 

Screen Window Maximum X 

Screen Window Maximum Y 

Screen Window Minimum X 

Screen Window Minimum Y 

Future Expansion 

Move Flag 

Characters Left in Output Buffer 

Padding Size 

Previous Plot Characters 

Right Margin 

Character Size 

Tab Table Size 

Type of Terminal 

Output Buffer Format 

Character Vertical Size 

Vector Intensity 

Imaginary Beam X 

Imaginery Beam Y 

Virtual Window Maximum X 

Virtual Window Maximum Y 

Virtual Window Minimum X 

Virtual Window Minimum Y 

Relative Vector Cosine Factor 

Real Beam X 

Real Beam Y 

Transformation Parameter 

Transformation Parameter 

Transformation Parameter 



TRPAR6 
TRSCAL 
TRSINF 



Virtual Graphics 
Virtual Graphics 
Virtual Graphics 



Transformation Parameter 
Relative Vector Scale Factor 
Relative Vector Sine Factor 
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III. TERMINAL CONTROL SYSTEM 
Glossary 



ABSOLUTE VECTOR 



ADE 

ALPHANUMERIC 
CURSOR 

ALPHANUMERIC 
MODE 

A/N 

ASCII 



BUFFERING 



CLIPPING 



COORDINATE 



CURSOR 



A directed line segment from a given starting point to a 
given end point. In screen graphics, the start point is 
defined by the beam position, and the end point is an 
absolute screen coordinate. In virtual graphics the start 
point is the virtual beam position and the end point is 
an absolute virtual coordinate. 

ASCII decimal equivalent. The integer representation of 
the ASCII character set. (See ASCII Code Chart.) 

A rectangular, non-stored, moveable marker which indicates 
the next position at which a character will be displayed. 

The Terminal mode in which ASCII output will be interpreted 
as characters to be displayed. 

Abbreviation for "alphanumeric." 

American Standard Code for Information Interchange: A 
standard code consisting of 7-bit elements for information 
interchange among data processing communications systems. 

Storing input or output in an array (in the Terminal 
Control System an array of 72 characters) which is trans- 
mitted or dumped when it is full or when a command to dump 
is given. 

The modification of virtual graphics vectors so that the 
portion of those vectors which lies outside of the virtual 
window will not be displayed on the screen. 

An ordered pair (X, Y) of numbers uniquely represent a point 
either on the screen or in virtual space. The ordered pair 
of numbers used in the normal coordinate system (Cartesian 
coordinates) represent the point according to its distance 
from the origin (0,0) along the X and Y-axis respectively. 

A moveable marker used as a reference. 
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DEFOCUS MODE 

DRAW 

ERASE 

GRAPHIC CURSOR 



Causes broader lines in the screen display; for the 
4014/15 Terminal. 

The display command which causes a bright vector to 
appear . 

The procedure of clearing the Terminal screen. 

A cross-hair cursor used to specify positional input. 
Not available on the 4006-1. 



HARDCOPY 



HOME POSITION 



INPUT 



KEYBOARD 



LEFT MARGIN 



LEVEL, RELEASE 



MOVE 



A permanent copy of a display on the Terminal screen 
which is made by a remote hardcopy unit. 

The upper-left corner screen location at which the 
first character of a page is normally printed. 

Data sent from the Terminal to the computer. Also, 
data provided to a subroutine. 

The portion of the Terminal which allows the user to 
enter A/N data into the computer. 

The screen X-coordinate which represents the starting 
position of a line of alphanumeric output. 

TCS was available in Releases 2.0 and 2.1, 3.0 to 3.3 
and Level 1 at the date of this printing. 

The display command which causes a dark vector to be 
drawn. 



NEW LINE 



NEW PAGE 



ORIGIN 



The operation which causes the alphanumeric cursor to 
go to the left margin and down one line. 

The operation which erases the screen and moves the 
alphanumeric cursor to the HOME position. 

The coordinate represented by (0,0). The origin of 
the screen is located at the lower-left corner. 
Virtual space, by definition, has its origin at its 
center. 
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POINT 
RASTER UNIT 

REFRESH 

RELATIVE VECTOR 
RIGHT MARGIN 



SCREEN 



SCREEN 
COORDINATES 



SCREEN WINDOW 

SOFTWARE 
STORAGE BEAM 

STORAGE TUBE 
TERMINAL 



The display command which causes a point to be drawn. 

The distance between two adjacent points on the screen; 
the basic resolution element of the Terminal. 

To renew a display. If a Terminal (i.e., a 4014/15 
Terminal) is in non-store mode, this display must be 
refreshed by the user's program to remain visible. 

A means of describing an absolute vector which is drawn 
relative to the current beam position. 

The screen X-coordinate which represents the rightmost 
limit of alphanumeric output. Any attempt to write to 
the screen beyond the right margin using an A/N output 
routine will cause a NEW LINE to be generated. 

The portion of the Terminal on which output from the 
computer is displayed. 

The set of points which constitutes the screen. These 
points form a discrete two-dimensional space and range 
from (0,0) to (1023, 1023) inclusive; the 4014/15 Terminal 
with Enhanced Graphic Module offers in addition a range 
from (0,0) to (4095 to 4095) inclusive. SCREEN COORDINATES 
MUST ALWAYS BE INTEGERS. 

The section of the screen into which the virtual window 
is scaled and translated. 

The programs and routines used to operate a computer. 

The electron beam which is directed by the output to 
draw characters and vectors on the Terminal Screen 

A cathode ray tube (CRT) which will maintain a display, 
once written, for an indefinite period until an erasure 
is made. 

A console which accepts data from or sends data to a 
computer. The term is used here with reference to a 
TEKTRONIX 4006-1, 4010, 4012/13 or 4014/15 Display Terminal, 
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TERMINAL STATUS 



The current state of the Terminal. 



TERMINAL STATUS 
AREA 



The set of common variables which represent the current 
Terminal status. 



TIMESHARING 



The use of a computer to serve a number of individuals 
in an essentially simultaneous fashion. Communication 
with a timesharing computer is usually through an 
interactive terminal. 



TRANSFORMATION 



USER COORDINATES 



VECTOR 



VIRTUAL 
COORDINATES 



The relationship between the virtual and screen windows. 
It may include a scaling, a translation, and/or a change 
of coordinate systems. 

A coordinate system in which the units of measurement 
are defined by the user. See virtual Coordinates. 

A line segment. A vector may be either bright (visible) 
or dark (invisible) . The former is generated by a DRAW 
routine, the latter by a MOVE routine. 

The set of points which constitute virtual space. 



VIRTUAL CURSOR 



VIRTUAL SPACE 



VIRTUAL WINDOW 



WRITE-THROUGH MODE 



Allows the user to locate coordinates in virtual space 
with the graphic cursor. 

A user-defined, data-structured display area which is 
Terminal independent. 

The portion of virtual space which is displayed in the 
Terminal area defined by the screen window. Only that 
portion of virtual space which is contained in the 
virtual window will be displayed. 

Allows refreshed information to be displayed along with 
stored information on the 4014/15 Terminal. 



Z-AXIS 



Allows variations in the storage and brightness capa- 
bilities on the 4014/15 Terminal. 



4010A01 User 



A-11 



APPENDIX B 



OPTION 22 USERS' INSTRUCTIONS 
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Option 22 (supported in TCS only with implementation for IBM 360/370) is the Tek- 
tronix 2741 Correspondence Code Interface. Its purpose is to allow communication 
between Tektronix 4010 family computer display terminals and IBM computer systems 
or other systems with 2741 ports. 4010 family terminals with Option 22 provide 
extended capabilities of graphics and faster alphanumerics through 2741 ports. 

There are two important points to be aware of when operating with an Option 22 
interface. 

SET I/O BUFFER SIZE 



In order for the FORTRAN routines ADEIN and ADEOUT to transmit data through an 
Option 22 interface, an encoding and decoding process is necessary. The TCS user 
need not be concerned with this encoding and decoding process except for its 
effect on the buffer size. 



TCS for IBM 360/370 has been changed to accomodate a buffer size of 89 charac- 
ters. This change was made because the encoding scheme for Option 22 results 
in some message overhead, decreasing the effective buffer size from 132 charac- 
ters to 89. Or, to put it the other way, an 89 character data message when 
encoded becomes a 132 character message. 

Because of this characteristic, the user must specifically set the input buffer 
size to 132 characters at the beginning of each session. The following ISO CLIST 
is an example: 

FREE ATTR(IN) FILE(FT05F001,FT06F001) 
ATTRIBUTE IN BLKSIZE(132) LRECL(132) RECFM(F) 
ALLOCATE DATASET(*) FILE(FT06F001) USING (IN) 
ALLOCATE DATASETO'O FILE(FT05F001) USING (IN) 

When the encoding process occurs, an 89 character message will be expanded to 
132 characters and the buffer will work properly. 

NON-ENCODED COMMUNICATION 

It will also be important to know how to communicate through the interface in non- 
encoded mode. Upon power up the terminal communicates in straight 2741 corre- 
spondence, without encoding. 

However TCS output and input received from the Option 22 interface will default to 
the encoded message mode. The user may exit from the encoded message input mode 
with a call to ANMODE, and the Option 22 will respond in non-encoded mode until a 
TCS input routine is called. The user's call to FINITT at the close of a session 
also returns the system to non-encoded mode. The ability of Option 22 to respond 
in either mode is important when mixing your own FORTRAN with TCS I/O. 
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I. SUBROUTINE AND FUNCTION INDEX 



ANCHO (I CHAR) 

ANMODE 

BAKSP 

BELL 

CARTN 

CSIZE (IHORZ, IVERT) 

DASHA (X, Y, L) 

DASHR (X, Y, L) 

DCURSR (ICHAR, IX, lY) 

DRAWA (X, Y) 

DRAWR (X, Y) 

DRWABS (IX, lY) 

DRWREL (IX, lY) 

DSHABS (IX, lY, L) 

DSHREL (IX, lY, L) 

ERASE 

FINITT (IX, lY) 

HDCOPY 

HOME 

INITT (IBAUD) 

KCM (RCM) 

KIN (RI) 

LINEF 

MOVABS (IX, lY) 

MOVEA (X, Y) 

MOVER (X, Y) 

MOVREL (IX, lY) 

NEWLIN 

NEWPAG 

PNTABS (IX, lY) 

PNTREL (IX, lY) 

POINTA (X, Y) 

POINTR (X, Y) 

RESTAT (RARRAY) 

SVSTAT (RARRAY) 

SWINDO (MINX, LENX, MINY, LENY) 

T INPUT (ICHAR) 

TOUTPT (ICHAR) 

VCURSR (ICHAR, X, Y) 

VWINDO (XMIN, XRANGE, YMIN, YRANGE) 

AlIN (NCHAR, lARRAY) 

AlOUT (NCHAR, lARRAY) 

AINST (NCHAR, lARRAY) 

ANSTR (NCHAR, lARRAY) 

AOUTST (NCHAR, lARRAY) 

CHRSIZ (ICHAR) 

CZAXIS (CODE) 

DASHSA (X, Y, L) 



PAGE 

4-1 

4-1 

4-3 

4-11 

4-3 

5-3 

3-13 

3-13 

4-3 

3-5 

3-7 

2-3 

2-4 

3-13 

3-13 

4-11 

2-2 

4-11 

4-3 

2-1 

4-13 

4-13 

4-2 

2-2 

3-5 

3-7 

2-4 

4-2 

4-3 

2-4 

2-4 

3-5 

3-7 

4-7 

4-7 

3-8 

7-4 

7-2 

4-5 

3-4 

7-5 

7-3 

7-5 

7-3 

7-3 

5-3 

5-2 

6-6 
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DASHSR (X, Y, L) 6-6 

DRAWSA (X, Y) 6-5 

DRAWSR (X, Y) 6-5 

DWINDO (XMIN, XMAX, YMIN, YMAX) 3-4 

INCPLT (lONOFF, IDIR, NO) 5-6 

LEFTIO (IBUFF) 7-10 

LINHGT (NUMLIN) 4-14 

LINTRN 6-4 

LINWDT (NUMCHR) 4-14 

LOGTRN (KEY) 6-4 

POLTRN (ANGMIN, ANGMAX, RSPRS) 6-4 

RECOVR 4-11 

RESET 4-11 

RROTAT (DEG) 4-9 

RSCALE (FACTOR) 4-9 

RSTTAB (ITAB, ITBTBL) 4-16 

SCURSR (ICHAR, IX, lY) 4-3 

SEEBUF (KFORM) 7-10 

SEEDW (XMIN, XMAX, YMIN, YMAX) 4-12 

SEELOC (IX, lY) 7-11 

SEEMOD (LINE, IZAXIS, MODE) 5-7 

SEEREL (RCOS, RSIN, SCALE) 4-12 

SEETRM (ISPEED, ITERM, ISIZE, MAXSR) 5-7 

SEETRN (XFAC, YFAC, KEY) 4-12 

SEETW (MINX, MAXX, MINY, MAXY) 4-12 

SETBUF (KFORM) 7-6 

SETMRG (MLEFT, MRIGHT) 4-19 

SETTAB (ITAB, ITBTBL) 4-15 

TABHOR (ITBTBL) 4-16 

TABVER (ITBTBL) 4-17 

TCSLEV (LEVEL) 4-19 

TERM (ITERM, ISCAL) 5-1 

TINSTR (LEN, lARRAY) 7-4 

TOUTST (NCHAR, lARRAY) 7-2 

TTBLSZ (ITBLSZ) 4-15 

TWINDO (MINX, MAXX, MINY, MAXY) 3-8 
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II. SUBJECT INDEX 



Al Output 7-3 

Al Input 7-5 

AM Output 7-3 

Absolute Line Drawing 2-2 , 3-5 

Alphanumeric Output ^-1> 7-2 

A/N Character Handling 4-2, 7-2 

A/N Character Output 4-1, 7-2 

A/N Mode 4-1,7-2 

A/N String Output 4-2, 7-3 

ASCII Input 7-4 

Bell 4-11 

Buffer Types 7-6, 7-10 

Changing Character Size 5-3 

Check the Terminal Mode 5-7 

Check the Terminal Status 5-7 

Circuit Drawing 7-7 

Clipping in Virtual Space 3-10 

Conversion of Centimeters to Screen Units 4-13 

Conversion of Inches to Screen Units 4-13 

Cursor 4-3, 4-5 

Dashed Lines 3-13, 6-6 

Dashed Line Specifications 3-13 

Drawing : 

Absolute 2-2, 3-5 

Relative 2-4, 3-7 

Dashed Lines 3-13 

Segmented Lines (Polar) 6-5 

Segmented Dashed Lines 6-6 

Hardcopying 4-11 

Horizontal Tab 4-16 

Identifying the Terminal 5-1 

Incremental Plotting 5-6 

Initialization 2-1 

Input 7-4 

Interchangeability of Virtual and Screen Graphics . . . 3-11 

Line Drawing 2-4 

Line Height 4-14, 3-5 

Line Width 4-14 

Linear Transformation 6-4 

Logarithmic Transformation 6-4 
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Margins 4-19 

Measuring the Height of Lines 4-14 

Measuring the Size of Characters 5-3 

Measuring the Width of Lines 4-14 

Miscellaneous Utility Routines 4-11 

Modifying the Z-axis 5-2 

Output 7-1, 2, 3 

Polar Transformation 6-4, 6-10 

Relative Drawing 2-4 , 3-7 

Removing a Tab 4-16 

Rescaling a Graphic Output 4-9 

Rotating a Graphic Output 4-9 

Scaling 3-8 

Screen Cursor 4-3 

Screen Graphics . 3-1, 3-8, 

3-11 

Screen Window 3-8 

Setting the Tab , 4-15 

Tabs 4-15, 4-17 

Tab Setting 4-15 

TEKTRONIX Terminals 1-2 

Terminal Control System Overview 1-2 

Terminal Status Area 4-7 

Transformations Sec. 6 

Utility Routines 4-11 

Utility I/O Routines . 7-6, 7-7 

Virtual Cursor 4-5 

Virtual Graphics 3-1 , 3-7 

Virtual Window 3-4 
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ASCII CODE CHART 
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